MCP connection guide

Connect your client

Add a remote Streamable HTTP server in a client that supports browser OAuth and dynamic client registration. Enter the URL below. Start the connection, sign in to NumiAgent, review the client and its redirect destination, then approve collection access.

The client discovers OAuth settings automatically and uses authorization code with S256 PKCE. If the email sign-in opens in another browser, reopen the client’s authorization link in the browser where you signed in.

https://numiagent.com/mcp

MCP protocol reference

NumiAgent serves MCP over stateless Streamable HTTP at /mcp. After OAuth, the client sends the access token in the Authorization header, sends initialize, and calls tools/list to retrieve the current tool input schemas. Call tools/call with a tool name and its arguments. Tools return structuredContent.data alongside a text representation. Entries such as unavailable marketplace coverage and insufficient valuation evidence appear in the returned data.

The OAuth server publishes its issuer, authorization and token endpoints, registration endpoint, and PKCE support in its discovery document. Use an MCP OAuth token for this endpoint and a NumiAgent API key for supported REST operations.

Tools and results

Tools return structured results. Try search_my_collection with a name such as Trajan or get_collection_statistics for specimen and photo counts. identify_coin_or_banknote reads candidate results for an existing upload. Marketplace tools report unavailable coverage when a source cannot provide current lots.

search_my_collection          query?, type?, page?
get_collection_item           itemId
get_collection_statistics     {}
list_my_themes                {}
get_missing_items             themeId
identify_coin_or_banknote     photoId
get_valuation                 itemId, currency?
get_recent_sales              itemId
search_market                 query
find_missing_items_for_sale   themeId, label

Review and revoke access

The collection:read scope lets an authorized agent read your collection, notes, valuation evidence and themes. Marketplace tools send query terms to configured providers. To disconnect a client, open Developer and choose Revoke client.