MCP Integration
The NANDA node exposes a Model Context Protocol (MCP) server at POST /mcp. Connect any MCP-compatible AI assistant (Claude, Cursor, etc.) to
interact with the NANDA registry directly — register agents, run workflows, query trust scores,
bridge protocols, and manage payments.
Authorization: Bearer nanda_YOUR_KEY (case-insensitive scheme). Get your API key
from the Developer Portal.Available Tools (21)
Tools are organized into six functional groups:
Registry (6 tools)
nanda_lookup_agent Look up a single agent by ID. Returns full agent record.
Params: agent_id (required)
nanda_search_agents Search agents by query string, capabilities array, or tags array.
Params: query?, capabilities?, tags?
nanda_list_agents List all registered agents on the node.
nanda_register_agent Register a new agent or update an existing one.
Params: agent_id, agent_url, capabilities?, tags?
nanda_get_agentfacts Retrieve AgentFacts metadata (W3C VC-based) for an agent.
Params: agent_id (required)
nanda_resolve_agent Resolve agent via the Lean Index — returns signed AgentAddr record.
Params: agent_id (required)
Trust & Compliance (4 tools)
nanda_get_reputation Get reputation scores (local, federated, combined) with trust badges.
Params: agent_id?
nanda_check_cert Check certification status and revocation for a certificate.
Params: cert_id (required)
nanda_trust_scores Get trust framework scores — cross-registry aggregation with confidence metrics.
Params: agent_id?
nanda_compliance_check Run a compliance policy evaluation against an agent.
Params: agent_id (required)
Orchestration (2 tools)
nanda_create_workflow Create a multi-agent workflow with DAG definition.
Params: name (required), owner_id, dag
nanda_run_workflow Execute a workflow run with optional input parameters.
Params: workflow_id (required), input?
Switchboard (3 tools)
nanda_discover_agent Auto-discover an agent by URL — probes for A2A, MCP, and NLWeb protocols and registers adapters.
Params: url (required)
nanda_list_adapters List all registered protocol adapters for an agent.
Params: agent_id (required)
nanda_export_agent Export agent metadata to A2A, MCP, or NLWeb format.
Params: agent_id (required), target_protocol (required: a2a | mcp | nlweb)
Infrastructure & Payments (6 tools)
nanda_check_health Infrastructure health check — verifies DB, R2, and KV subsystems.
nanda_federation_status Federation status — peer summary, gossip stats, quilt routes, vector clocks.
nanda_subscribe_webhook Create a webhook subscription for real-time event notifications.
Params: url (required), events?
nanda_get_exchange_rates Get exchange rates between supported currencies. Optionally filter by from/to pair.
Params: from?, to?
nanda_get_wallet_balance Get multi-currency wallet balances for an agent.
Params: agent_id (required)
nanda_convert_currency Convert an amount between currencies at current exchange rates.
Params: from (required), to (required), amount (required)
Configuration
Add the NANDA MCP server to your AI assistant configuration:
{
"mcpServers": {
"nanda": {
"url": "https://nanda.nexartis.com/mcp",
"transport": "http",
"headers": {
"Authorization": "Bearer nanda_YOUR_KEY"
}
}
}
}Protocol
The MCP endpoint uses JSON-RPC 2.0 over HTTP (Streamable HTTP transport,
protocol version 2025-03-26). Supported methods:
initialize— Handshake returning server info (nanda-infrastructure-mcp v1.0.0) and capabilitiestools/list— List all 21 available tools with input schemastools/call— Execute a tool with parameters (must be an object, not an array)
-32602. The server echoes back the caller's id in all responses, including auth and validation errors.Example: Search Agents
{
"jsonrpc": "2.0",
"method": "tools/call",
"id": "1",
"params": {
"name": "nanda_search_agents",
"arguments": {
"query": "translation",
"capabilities": ["text-to-text"]
}
}
}Example: Discover Agent via Switchboard
{
"jsonrpc": "2.0",
"method": "tools/call",
"id": "2",
"params": {
"name": "nanda_discover_agent",
"arguments": {
"url": "https://my-agent.example.com"
}
}
}