# MCP tools/list example — mcp.kasanegi.com

Last updated: 2026-05-07. This page documents the live JSON-RPC 2.0
exchange against the kasanegi.com MCP entrance. It is reproducible
without any secret. Tools and routing are derived from the
product-contract registry shared with the broker gateway, so the
canonical buyer paths reported here always match
https://api.kasanegi.com/openapi.json.

## Endpoint

- POST https://mcp.kasanegi.com/mcp
- Transport: streamable-http (JSON-RPC 2.0)
- Protocol: MCP 2025-06-18

## 1. initialize

    curl -s -X POST -H 'Content-Type: application/json' \
      -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
      https://mcp.kasanegi.com/mcp

Returns server info, protocolVersion, and capabilities. capabilities
includes `tools` so the next call is tools/list.

## 2. tools/list

    curl -s -X POST -H 'Content-Type: application/json' \
      -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
      https://mcp.kasanegi.com/mcp

Returns one tool per public-sold endpoint in the registry. Tool names
match `mcp_tool_name` from the registry. inputSchema is generated
from the registry param specs (type / pattern / enum / minimum /
maximum / default).

## 3. tools/call (metadata transition response)

    curl -s -X POST -H 'Content-Type: application/json' \
      -d '{
        "jsonrpc": "2.0",
        "id": 3,
        "method": "tools/call",
        "params": {
          "name": "<tool name from tools/list>",
          "arguments": {}
        }
      }' \
      https://mcp.kasanegi.com/mcp

The current implementation returns a transition payload with the
canonical broker-gateway preview URL (wallet-free) and production URL
(x402-paid) on https://api.kasanegi.com. To execute the call, the agent uses the
preview URL directly, or replays the production URL with an x402
client. Buyers that prefer card / platform credit subscribe through
the marketplace listing; see https://api.kasanegi.com/ai-review for the full path
matrix.

This is documented as metadata-only on purpose: the MCP entrance does
not proxy the upstream call body. Full proxying happens at the broker
gateway on https://api.kasanegi.com.

## ping

    curl -s -X POST -H 'Content-Type: application/json' \
      -d '{"jsonrpc":"2.0","id":4,"method":"ping","params":{}}' \
      https://mcp.kasanegi.com/mcp

Returns an empty result. Useful for liveness checks.