HTTP
Send JSON-RPC requests over Streamable HTTP.
Configure this client in Quick Start.
Before you start
Prepare curl and a DINQ API Key. Initialize the connection, send the initialization acknowledgement, then call capabilities; do not skip the protocol handshake.
See Authentication and API Keys for credential options. Merge only the peoplerouter entry into an existing configuration; do not overwrite other settings.
Set up the connection
# 1. initialize — read Mcp-Session-Id from the response headers
curl -si https://mcp.peoplerouter.ai \
-H "Authorization: Bearer <DINQ_API_KEY>" \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
# 2. copy the returned session id and negotiated protocolVersion below
SESSION='<Mcp-Session-Id>'
PROTOCOL='2025-06-18'
# acknowledge
curl -s https://mcp.peoplerouter.ai \
-H "Authorization: Bearer <DINQ_API_KEY>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-H "Mcp-Session-Id: $SESSION" -H "MCP-Protocol-Version: $PROTOCOL" -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'
# 3. call a tool
curl -s https://mcp.peoplerouter.ai \
-H "Authorization: Bearer <DINQ_API_KEY>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-H "Mcp-Session-Id: $SESSION" -H "MCP-Protocol-Version: $PROTOCOL" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"capabilities","arguments":{}}}'Or send this to your agent
Copy these instructions into your agent to help with setup.
Connect PeopleRouter in HTTP. Check the installed version first and use this setup:
# 1. initialize — read Mcp-Session-Id from the response headers
curl -si https://mcp.peoplerouter.ai \
-H "Authorization: Bearer <DINQ_API_KEY>" \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
# 2. copy the returned session id and negotiated protocolVersion below
SESSION='<Mcp-Session-Id>'
PROTOCOL='2025-06-18'
# acknowledge
curl -s https://mcp.peoplerouter.ai \
-H "Authorization: Bearer <DINQ_API_KEY>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-H "Mcp-Session-Id: $SESSION" -H "MCP-Protocol-Version: $PROTOCOL" -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'
# 3. call a tool
curl -s https://mcp.peoplerouter.ai \
-H "Authorization: Bearer <DINQ_API_KEY>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-H "Mcp-Session-Id: $SESSION" -H "MCP-Protocol-Version: $PROTOCOL" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"capabilities","arguments":{}}}'
If an API key is needed, guide me to configure it locally rather than paste it into chat. If sandbox restrictions block configuration or authorization through file, network or browser callback access, request the necessary permissions through the current agent's approval mechanism. Where outside-sandbox execution is supported, run the operation only after approval. I will complete browser authorization. Do not repeatedly retry in the same restricted environment, disable the sandbox or bypass approvals. If the environment cannot request permission, give me the exact steps to perform in my local terminal or app UI. Back up existing configuration and merge only peoplerouter, preserving other servers and settings. Check an existing entry instead of adding a duplicate. Web apps require adding the connector in their UI; guide me if you cannot do that directly. Confirm success only after tools load and capabilities succeeds; otherwise report the actual error.This example needs an API Key. Create one in the console and enable it in developer settings. Authentication and API Keys
Check the connection
The SDK / HTTP examples use the capabilities response to check the connection. The API examples may continue with a people search: review the input and tool prices before running them. An HTTP success status alone does not establish a successful tool result.
After connecting, continue to Using tools. For authentication or tool errors, read Troubleshooting and inspect the client's actual error message.