Agent Kiosk MCP Server

Agent Kiosk — 24-in-1 Autonomous B2A Intelligence, Action & Compliance Supermarket (x402 v2 & MCP)

Agent Kiosk is an instant pay-per-call API and Model Context Protocol (MCP) server built for autonomous AI agents, trading bots, coding assistants, and research workflows on Base Mainnet (eip155:8453). Every paid and prepaid response includes a cryptographic SHA-256 + HMAC-SHA256 attestation envelope (attested tag).

• Production Base URL: https://agent-kiosk.vercel.app
• Merchant Payment Recipient (payTo): 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95 (Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 decimals)
• Catalogue Scope: 24 x402-protected endpoints (23 paid per-call endpoints + 1 prepaid 30-day API pass) plus free discovery, telemetry, MCP teaser & partner-fee swap routes
• Live Telemetry & Wallet Dashboard: https://agent-kiosk.vercel.app/stats (GET /v1/stats JSON)
• MCP Endpoint: https://agent-kiosk.vercel.app/mcp (https://agent-kiosk--batuhansenavci.run.tools)
• x402scan Store (24/24 Verified): x402scan.com/server/a1af2789-615a-4324-b3f1-83b97834ece8
• Glama MCP Listing: glama.ai/mcp/servers/ralf9090/agent-kiosk
• Smithery Store: smithery.ai/servers/batuhansenavci/agent-kiosk

---

1. Unified Route, Method & Price Catalogue

A. 23 Paid Per-Call x402 Endpoints (Base USDC eip155:8453)

All /v1/* routes accept POST (primary JSON body) and GET (query parameters). Unauthenticated requests return HTTP 402 Payment Required with the PAYMENT-REQUIRED header.

B. 1 Prepaid 30-Day API Pass Endpoint (Base USDC eip155:8453)

C. Free / Unpaid Routes ($0.00 USDC — HTTP 200 without x402 payment)

---

2. Production x402 Buyer Guide & Facilitator Integration

A. Base Mainnet Settlement Facilitators (We Are the Seller, Not a Facilitator)

Agent Kiosk verifies and settles incoming EIP-3009 (TransferWithAuthorization) USDC signatures on Base Mainnet (eip155:8453 / base) using a multi-facilitator failover pipeline configured in src/x402.js:

• Merchant Receiving Address (payTo): 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95 (Base Mainnet USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 decimals).

B. Accepted Payment, Challenge & Receipt Headers

C. Timeouts, Uncertain Settlement & Recovery Instructions

1. Server & Challenge Timeouts:
   • Every 402 Payment Required challenge specifies maxTimeoutSeconds: 60. Buyers should sign EIP-3009 TransferWithAuthorization messages with validAfter = 0 and validBefore >= now + 300 seconds.
   • Server-side facilitator calls enforce a 6.5-second timeout per facilitator on POST /verify and a 10.0-second timeout per facilitator on POST /settle.
   • If the primary facilitator (facilitator.payai.network) returns an HTTP/network error on /verify or /settle, the middleware automatically fails over to the next configured facilitator (facilitator.dexter.cash). If a signature is cryptographically invalid (invalid_exact_evm_signature), the server immediately returns HTTP 402 with the exact error reason without retrying.
2. Handling Uncertain Settlement (Client Timeout / Network Drop):
   • Each EIP-3009 TransferWithAuthorization uses a unique 32-byte nonce. Once consumed on Base Mainnet, the USDC contract (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) permanently marks that (authorizer, nonce) pair as used (AuthorizationUsed event), making replay or double-charging of the same signature impossible on-chain.
   • Rule for Buyers on Timeout: If your HTTP request times out or disconnects after sending PAYMENT-SIGNATURE, do NOT immediately sign a new nonce:
     1. Query Base USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) via authorizationState(address authorizer, bytes32 nonce) (0xe94a0102) or check https://basescan.org/address/0xd8429209Aee6A398B9707DFf5F28AAA93452eE95#tokentxns.
     2. If authorizationState is false (not settled on-chain): You can safely retry the request using the exact same PAYMENT-SIGNATURE header (same nonce) until validBefore expires, or wait for validBefore to pass before signing a new nonce.
     3. If authorizationState is true (settled on-chain, but HTTP response was lost in transit): Open an issue at github.com/ralf9090/agent-kiosk/issues with the Base txHash, endpoint path, and timestamp for immediate response replay or a complimentary Prepaid API Pass credit.

---

3. Verified Base Mainnet Settlement Evidence (Operator Tests)

Disclosure: The transactions below are operator test payments executed against the live production deployment (https://agent-kiosk.vercel.app) and settled on Base Mainnet (eip155:8453) via the PayAI Network facilitator (https://facilitator.payai.network/settle), not third-party customer volume.

Example 1 — POST https://agent-kiosk.vercel.app/v1/token-alpha (0.02 USDC / 20000 atomic units)

• Endpoint & Method: POST https://agent-kiosk.vercel.app/v1/token-alpha
• Amount Settled: 0.02 USDC (20000 atomic units, Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
• Base Mainnet Transaction Link: https://basescan.org/tx/0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be (Block 52809684, Status: Success)
• Facilitator Relayer (from on-chain): 0xc6699d2aadA6c36Dfea5C248DD70f9CB0235cB63 (PayAI Network relayer)
• Seller Recipient (payTo): 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95

Decoded PAYMENT-RESPONSE / X-PAYMENT-RESPONSE Header:

{
  "success": true,
  "transaction": "0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be",
  "network": "eip155:8453",
  "payer": "0xd8429209aee6a398b9707dff5f28aaa93452ee95"
}

Redacted HTTP 200 Resource Response (POST /v1/token-alpha with {"query":"AERO","chain":"base"}):

{
  "ok": true,
  "payment_mode": "x402",
  "tx_hash": "0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be",
  "attestation": {
    "attested": true,
    "issuer": "io.github.ralf9090/agent-kiosk",
    "signer_wallet": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "algorithm": "HMAC-SHA256",
    "route": "/v1/token-alpha",
    "payload_sha256": "c1bcebf107e25a742a7afc58ca39692bc33f4e6da49a2ca1afc8b892fae63a1f",
    "timestamp_utc": "2026-10-19T11:18:33.296Z",
    "signature": "<REDACTED_ATTESTATION_HMAC>"
  },
  "data": {
    "query": "AERO",
    "found": true,
    "token": {
      "name": "Aerodrome",
      "symbol": "AERO",
      "address": "0x940181a94A35A4569E4529A3CDfB74e38FD98631",
      "primary_chain": "base",
      "price_usd": 0.7866,
      "market_cap_usd": 789632423,
      "fdv_usd": 1575158274
    },
    "alpha_metrics": {
      "signal": "SELL_PRESSURE",
      "total_top5_liquidity_usd": 47963273,
      "volume_1h_usd": 403817,
      "volume_24h_usd": 12606349,
      "order_flow_1h": { "buys": 88, "sells": 495, "buy_pressure_pct": 15.1 },
      "order_flow_24h": { "buys": 3508, "sells": 13997, "buy_pressure_pct": 20 }
    },
    "llm_summary": "Aerodrome (AERO on base): $0.7866 | Signal: SELL_PRESSURE | 1h Buy Pressure: 15.1% (88 buys vs 495 sells) | Liquidity: $47,963,273 | 24h Vol: $12,606,349."
  }
}

Example 2 — POST https://agent-kiosk.vercel.app/v1/ping (0.001 USDC / 1000 atomic units)

• Endpoint & Method: POST https://agent-kiosk.vercel.app/v1/ping
• Amount Settled: 0.001 USDC (1000 atomic units)
• Base Mainnet Transaction Link: https://basescan.org/tx/0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e (Block 52809683, Status: Success)
• Facilitator Relayer (from on-chain): 0xB2Bd29925CBbCEA7628279c91945Ca5B98bf371B (PayAI Network relayer)

Decoded PAYMENT-RESPONSE / X-PAYMENT-RESPONSE Header:

{
  "success": true,
  "transaction": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e",
  "network": "eip155:8453",
  "payer": "0xd8429209aee6a398b9707dff5f28aaa93452ee95"
}

Redacted HTTP 200 Resource Response (POST /v1/ping with {"message":"x402-registry-verification"}):

{
  "ok": true,
  "payment_mode": "x402",
  "tx_hash": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e",
  "attestation": {
    "attested": true,
    "issuer": "io.github.ralf9090/agent-kiosk",
    "signer_wallet": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "algorithm": "HMAC-SHA256",
    "route": "/v1/ping",
    "payload_sha256": "6fc2d484b7899b71b18d80b87c18230e8904e7f296ca3c471763cc618a932041",
    "timestamp_utc": "2026-10-19T11:18:31.280Z",
    "signature": "<REDACTED_ATTESTATION_HMAC>"
  },
  "data": {
    "status": "pong",
    "verified": true,
    "payment_mode": "x402",
    "service": "Agent Kiosk",
    "version": "2.6.0",
    "protocol": "x402 v2 & v1 + MCP (Attested)",
    "network": "eip155:8453",
    "asset": "USDC",
    "echo": "x402-registry-verification",
    "payer": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "tx_hash": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e"
  }
}

---

4. Quick Connect (Claude Desktop / Cursor / Windsurf / VS Code)

{
  "mcpServers": {
    "agent-kiosk": {
      "url": "https://agent-kiosk.vercel.app/mcp"
    }
  }
}