Invoke an MCP tool

Model Context Protocol JSON-RPC 2.0 entry point. Dispatches to one of five tools: search, check_guardrails, check_facts, get_article, find_related. Use the MCP client libraries (@modelcontextprotocol/sdk) for idiomatic access rather than raw HTTP.

post/mcp

Request

  • Base URL: https://mcp.rrmacademy.org
  • URL: https://mcp.rrmacademy.org/mcp
  • Auth: HTTP bearer

Headers

Idempotency-Keystring
Example:f47ac10b-58cc-4372-a567-0e02b2c3d479

Opaque client-generated identifier (recommend 36-character UUID) that lets the server detect retried requests on this mutation endpoint and return the cached prior response instead of re-running side effects. Implements the IETF idempotency-header draft (https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/). Constraints: 16-128 printable ASCII characters. The server returns the same status, body, and Idempotency-Replayed: true on a successful match. If the same key is reused with a different request body, the server returns 422 with error=idempotency-mismatch. Keys expire after 24 hours. Idempotency is opt-in: requests without this header behave exactly as before.

Request body

jsonrpc'2.0' required
method'tools/list' | 'tools/call' | 'initialize' required
paramsobject

For tools/call: { name: string, arguments: object }. Tool names: search, check_guardrails, check_facts, get_article, find_related.

Response

JSON-RPC response envelope

jsonrpc'2.0' required
resultobject

Changes

No recorded changes to this operation across all 1 revision of this API.