Skip to main content

Using the Reference

Every page in the Reference embeds a "Try it" widget so you can call the server straight from the docs. Here's the same widget pointed at mdmcp-search_brands:

Loading interactive widget…

How it works​

The widget makes two JSON-RPC requests:

  1. initialize — handshake to negotiate the protocol version
  2. The method shown on the page (tools/call, resources/read, etc.)

Both carry the x-api-key you enter in the widget's key field and go to the endpoint shown in the input box. The response is rendered raw, exactly as the server returned it — what you'd see with curl or an SDK, minus the setup.

Edit the JSON arguments before sending to explore a tool's behavior: change the query, raise the search_limit, or pass a list of queries to try batching.

Limitations​

  • Auth — paste your x-api-key into the widget's key field; it's stored in your browser only (localStorage) and sent on every call. Without an MCP-enabled key the server returns 401 — see Authentication & access.
  • Streaming — for tools that respond with SSE, only the final message is rendered; intermediate progress notifications are dropped.
  • One call at a time — the widget is for exploring single calls. For multi-step flows, connect a real client: see Connect a custom client.