MCP API

The public MCP-over-HTTP endpoint exposes the same retrieval service through JSON-RPC. Use it when you have an MCP-capable client or agent runtime.

Endpoint: https://agents.quantumsoftwarelab.com/mcp

Transport

Send JSON-RPC requests with POST /mcp. Notifications that do not require a response return HTTP 202 with an empty body.

Implemented methods

initialize
tools/list
tools/call
notifications/initialized as a notification

Available tools

Tool	Use
`sources`	List enabled datasources.
`source`	Return one datasource's metadata.
`documents`	List documents in one datasource with bounded metadata filters.
`document`	Fetch one stable document by `document_id`.
`sections`	List sections for one document.
`search`	Search passages by query, datasource, mode, limit, and optional document/section scope.
`passage`	Fetch one stable passage by `passage_id`.

Example: list tools

curl -fsS   -H 'Content-Type: application/json'   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'   https://agents.quantumsoftwarelab.com/mcp

Example: document browse tool call

curl -fsS   -H 'Content-Type: application/json'   -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"documents","arguments":{"datasource":"qsl-papers","author":"hopper","limit":5}}}'   https://agents.quantumsoftwarelab.com/mcp

Example: scoped search tool call

curl -fsS   -H 'Content-Type: application/json'   -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search","arguments":{"datasource":"qsl-papers","document_id":"paper-a","query":"quantum software","mode":"keyword","limit":2}}}'   https://agents.quantumsoftwarelab.com/mcp

When to use MCP

Use MCP when your agent runtime already speaks JSON-RPC MCP.
Use the REST API when a simple HTTP client is enough.
In both cases, preserve returned datasource and passage identifiers when citing evidence.