# RAMSAPS Agent Gateway — Model Context Protocol (MCP) & Agentic Tools
> RAMSAPS provides programmatic micro-utilities designed for autonomous AI agents, LLM tool-calling systems, and machine-to-machine computing workflows.

## System Overview
- **Protocol**: Model Context Protocol (MCP) Streamable HTTP & JSON-RPC 2.0
- **Official Registry (Smithery)**: `chuster2019/ramsaps-seo-optimizer` (https://smithery.ai/server/@chuster2019/ramsaps-seo-optimizer)
- **Install Command**: `npx -y @smithery/cli install @chuster2019/ramsaps-seo-optimizer`
- **Live Direct Endpoint**: https://ramapps.vercel.app/api/mcp
- **Discovery Card**: https://ramapps.vercel.app/.well-known/mcp.json
- **Payment Standard**: HTTP 402 / x402
- **Supported Payment Networks**: Base Mainnet (USDC)
- **Settlement Facilitator**: x402-native-settler
- **Treasury Address**: `0x71C8A9b97b0F5489812fC071239cEa6907B6402A`

## Active Pilot Tools

### 1. seo-optimizer
- **Name**: `seo-optimizer`
- **Smithery ID**: `chuster2019-ramsaps-seo-optimizer.seo-optimizer`
- **Description**: Automated Agentic SEO & AEO (Answer Engine Optimization) engine. Structures content for optimal visibility across search engines and AI agent retrieval systems (Perplexity, ChatGPT, Claude, Gemini, SearchGPT).
- **Execution Cost**: $0.010 USDC per call (or 1 RAMSAPS credit)
- **Input Parameters**:
  - `text` (string, required): Content body to optimize.
  - `keywords` (string, required): Target keywords separated by comma.
  - `platform` (string, optional, default: "Website"): Publishing platform ("Website", "Blog", "E-commerce", "Social Media", "Documentation").
- **MCP Call Example**:
  ```json
  {
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "seo-optimizer",
      "arguments": {
        "text": "Antigravity is an advanced agentic coding system.",
        "keywords": "AI agent tools, MCP server, x402 micropayments",
        "platform": "Website"
      }
    },
    "id": 1
  }
  ```
- **Payment Flow (x402)**:
  1. Call `POST https://ramapps.vercel.app/api/mcp` with the JSON-RPC payload.
  2. If unauthenticated, receive `HTTP 402 Payment Required` with `WWW-Authenticate: x402` header containing price ($0.01 USDC), treasury wallet, and challenge ID.
  3. Settle transaction on Base Mainnet and resubmit with header `X-Payment-Proof: x402_tx_<TRANSACTION_HASH>`.
  4. Receive immediate structured output.

## Full Documentation & Specifications
- [Full LLM Specification](https://ramapps.vercel.app/llms-full.txt)
- [MCP Well-Known Discovery Card](https://ramapps.vercel.app/.well-known/mcp.json)
- [Robots Configuration](https://ramapps.vercel.app/robots.txt)