music nerd

MCP serverSend an MCP message

MCP server

Send an MCP message

Sends a JSON-RPC 2.0 MCP message, or a batch, and streams the responses as server-sent events. Every request needs an OAuth access token. tools/list returns the tools this connection can use, with their input schemas.

POST/mcp
POST/mcp

Sends a JSON-RPC 2.0 MCP message, or a batch, and streams the responses as server-sent events. Every request needs an OAuth access token. tools/list returns the tools this connection can use, with their input schemas.

This one can’t run in the browser. Copy the curl and run it from a terminal.

Authorization

Authorizationstringrequired

An OAuth access token for https://api.musicnerd.net/mcp, scope mcp:tools. An MCP client gets one by adding the server URL: a Music Nerd page opens, the user signs in with Privy and approves the agent. Tokens last five minutes and refresh on their own; disconnecting the agent stops them at once. See MCP resource metadata. Kept in this tab only.

Body
cURL
curl --request POST \
  --url 'https://musicnerd-api.vercel.app/mcp' \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "example-client",
      "version": "1.0.0"
    }
  }
}'

Send the request to see the live response here.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. An OAuth access token for https://api.musicnerd.net/mcp, scope mcp:tools. An MCP client gets one by adding the server URL: a Music Nerd page opens, the user signs in with Privy and approves the agent. Tokens last five minutes and refresh on their own; disconnecting the agent stops them at once. See MCP resource metadata.

Body

application/jsonrequired
jsonrpcstring · enumrequired

Values: "2.0"

idinteger | string

Omit for a notification; the server then answers 202 with no body.

methodstringrequired

initialize, tools/list, tools/call, ping, or a notification such as notifications/initialized.

paramsobject

For tools/call: { name, arguments }.

Response

text/event-stream

The responses, one message event per JSON-RPC response. A failed tool call is a result with isError: true.

string