Request example testing curl commands for the example servers such as memory running on an httpAddr

[ningdeng]

Pre-submission Checklist

• I have checked that this question would not be more appropriate as an issue in a specific repository
• I have searched existing discussions and documentation for answers

Question Category

• Protocol Specification
• SDK Usage
• Server Implementation
• General Implementation
• Documentation
• Other

Your Question

I would like to request complete examples for using the example MCP servers, I tried to run the mcp server on my localhost and curl to it for testing before connecting it with agents, but it keeps error out, e.g., for the example hello MCP server, i keep getting the following error:

curl -X POST http://localhost:8888/greet \
>   -H "Content-Type: application/json" \
>   -H "Accept: application/json,text/event-stream" \
>   -d '{
>     "jsonrpc": "2.0",
>     "method": "greet",
>     "params": {}
>     }'
JSON RPC not handled: "greet" unsupported

I did call:

curl -X POST http://localhost:8888 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {
        "tools": {}
      },
      "clientInfo": {
        "name": "curl-client",
        "version": "1.0.0"
      }
    },
    "id": 1
  }'

and
curl -v -X POST http://localhost:8888 -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

[cananoo]

There are two separate issues here:

1. examples/server/hello uses mcp.StdioTransport, so it is a stdio-only server and does not expose an HTTP endpoint. You cannot call it with curl unless you change the example to use NewStreamableHTTPHandler (the examples/http program is the HTTP example).
2. For the memory example, the MCP endpoint is the root URL (http://localhost:8888/). greet is a tool name, not an HTTP path or a JSON-RPC method. Tool calls use the tools/call method.

Run the memory example from the repository root:

go run ./examples/server/memory -http :8888

Then use a stateful streamable-HTTP session. The first request returns an Mcp-Session-Id; copy that value from the response headers:

curl -i http://localhost:8888/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data-raw '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Complete the handshake (replace <SESSION_ID>):

curl -i http://localhost:8888/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -H "Mcp-Protocol-Version: 2025-06-18" \
  --data-raw '{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}'

List tools and call one of the memory tools:

curl http://localhost:8888/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -H "Mcp-Protocol-Version: 2025-06-18" \
  --data-raw '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

curl http://localhost:8888/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -H "Mcp-Protocol-Version: 2025-06-18" \
  --data-raw '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_nodes","arguments":{"query":"Ada"}}}'

The notifications/initialized request also needs Content-Type: application/json; the request in the question omits it. The current transport requirements and the memory server implementation are documented in mcp/streamable_client.go, mcp/streamable_server.go, and examples/server/memory/main.go.