ThunderPhone ਨੂੰ MCP ਸਰਵਰ ਵਜੋਂ ਵਰਤੋ

ThunderPhone ਇੱਥੇ ਇੱਕ ਮਾਡਲ ਕਾਂਟੈਕਸਟ ਪ੍ਰੋਟੋਕੋਲ ਸਰਵਰ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ:

https://api.thunderphone.com/v1/mcp

ਆਪਣੀ ਸੰਸਥਾ ਦੇ ਏਜੰਟਾਂ ਅਤੇ ਕਾਲਾਂ ਨੂੰ ਟੂਲਾਂ ਵਜੋਂ ਉਪਲਬਧ ਕਰਨ ਲਈ ਕਿਸੇ MCP ਕਲਾਇੰਟ ਨੂੰ ਉਸ Streamable HTTP ਐਂਡਪੌਇੰਟ ਵੱਲ ਪੁਆਇੰਟ ਕਰੋ। ਇਹ ਕਿਸੇ ਰਿਮੋਟ MCP ਸਰਵਰ ਨੂੰ ਵੌਇਸ ਏਜੰਟ ਨਾਲ ਜੋੜਨ ਦੇ ਉਲਟ ਦਿਸ਼ਾ ਹੈ:

ਦਿਸ਼ਾ	ਨਤੀਜਾ
ਰਿਮੋਟ MCP ਸਰਵਰ → ThunderPhone ਏਜੰਟ	ਤੁਹਾਡਾ ਵੌਇਸ ਏਜੰਟ ਰਿਮੋਟ ਸਰਵਰ ਦੇ ਟੂਲਾਂ ਨੂੰ ਕਾਲ ਕਰ ਸਕਦਾ ਹੈ।
ThunderPhone → ਤੁਹਾਡਾ MCP ਕਲਾਇੰਟ	ਤੁਹਾਡਾ MCP ਕਲਾਇੰਟ ਏਜੰਟਾਂ ਅਤੇ ਕਾਲਾਂ ਲਈ ThunderPhone ਟੂਲਾਂ ਨੂੰ ਕਾਲ ਕਰ ਸਕਦਾ ਹੈ।

ਪ੍ਰਮਾਣੀਕਰਨ ਕਰੋ

ਸੰਸਥਾ → ਕੁੰਜੀਆਂ ਹੇਠ ਇੱਕ sk_live_ ਕੁੰਜੀ ਬਣਾਓ ਅਤੇ ਇਸਨੂੰ Bearer ਟੋਕਨ ਵਜੋਂ ਭੇਜੋ। MCP ਐਂਡਪੌਇੰਟ ਸੰਸਥਾ API ਕੁੰਜੀਆਂ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ, ਡੈਸ਼ਬੋਰਡ ਸੈਸ਼ਨ ਕੂਕੀਜ਼ ਜਾਂ ਪ੍ਰਕਾਸ਼ਿਤ ਕਰਨ ਯੋਗ ਵਿਜਿਟ ਕੁੰਜੀਆਂ ਨਹੀਂ।

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

ਉਪਲਬਧ ਟੂਲ

ਟੂਲ	ਆਰਗੂਮੈਂਟ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_agents`	ਕੋਈ ਨਹੀਂ	id, ਨਾਮ, ਪ੍ਰੋਡਕਟ ਅਤੇ ਵੌਇਸ ਸਮੇਤ ਸੰਸਥਾ ਦੇ ਏਜੰਟਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`get_agent`	`agent_id`	ਇੱਕ ਏਜੰਟ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`place_call`	`agent_id`, `from_number`, `to_number`	REST ਕਾਲ ਐਂਡਪੌਇੰਟ ਵਰਗੀ ਹੀ ਵੈਲੀਡੇਸ਼ਨ ਅਤੇ ਬਿਲਿੰਗ ਜਾਂਚਾਂ ਨਾਲ ਆਊਟਬਾਊਂਡ ਕਾਲ ਕਰਦਾ ਹੈ।
`get_call`	`call_id`	ਕਾਲ ਦੀ ਸਥਿਤੀ, ਸੰਖੇਪ ਅਤੇ ਗ੍ਰੇਡ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`list_calls`	ਵਿਕਲਪਿਕ `limit` (1–100), ਵਿਕਲਪਿਕ `status`	ਹਾਲੀਆ ਕਾਲਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`get_call_transcript`	`call_id`	ਕਾਲ ਲਈ ਪੂਰਾ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।

ਸਾਰੇ ਟੂਲ API ਕੁੰਜੀ ਨਾਲ ਬੰਨ੍ਹੀ ਸੰਸਥਾ ਤੱਕ ਸੀਮਿਤ ਹਨ। ਕਿਸੇ ਹੋਰ ਸੰਸਥਾ ਦੀ id ਅਣਉਪਲਬਧ ਮੰਨੀ ਜਾਂਦੀ ਹੈ।

ਪ੍ਰੋਟੋਕੋਲ ਵਿਧੀਆਂ

ਐਂਡਪੌਇੰਟ Streamable HTTP ਕਲਾਇੰਟਾਂ ਲਈ ਲੋੜੀਂਦੀਆਂ MCP JSON-RPC ਵਿਧੀਆਂ ਨੂੰ ਲਾਗੂ ਕਰਦਾ ਹੈ:

initialize
notifications/initialized
tools/list
tools/call

ਤੁਸੀਂ ਟੂਲ ਕੈਟਾਲੌਗ ਨੂੰ ਸਿੱਧਾ ਦੇਖ ਸਕਦੇ ਹੋ:

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

ਕਿਸੇ ਟੂਲ ਨੂੰ ਇਸਦੇ ਨਾਮ ਅਤੇ ਆਰਗੂਮੈਂਟਾਂ ਨਾਲ ਕਾਲ ਕਰੋ:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

ਟੂਲ ਨਤੀਜੇ MCP ਟੈਕਸਟ-ਕੰਟੈਂਟ ਆਈਟਮਾਂ ਹੁੰਦੇ ਹਨ। ਟੂਲ ਅਸਫਲਤਾਵਾਂ ਨਤੀਜੇ ਵਿੱਚ isError: true ਨਾਲ ਵਾਪਸ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ; ਅਣਜਾਣ JSON-RPC ਵਿਧੀਆਂ ਇੱਕ ਪ੍ਰੋਟੋਕੋਲ ਗਲਤੀ ਵਾਪਸ ਕਰਦੀਆਂ ਹਨ।

ਕਾਲਾਂ ਸੁਰੱਖਿਅਤ ਢੰਗ ਨਾਲ ਕਰਨਾ

place_call ਉਹੀ ਨਿਯਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੈ ਜੋ POST /v1/call ਕਰਦਾ ਹੈ: ਏਜੰਟ ਅਤੇ ਨੰਬਰ ਕੁੰਜੀ ਦੀ ਸੰਸਥਾ ਨਾਲ ਸਬੰਧਿਤ ਹੋਣੇ ਚਾਹੀਦੇ ਹਨ, ਨੰਬਰ ਆਊਟਬਾਊਂਡ ਕਾਲਿੰਗ ਲਈ ਯੋਗ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ, ਸੰਸਥਾ ਕੋਲ ਲੋੜੀਂਦਾ ਬਕਾਇਆ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ, ਅਤੇ ਲਾਗੂ ਹੋਣ ਵਾਲੀ ਕੋਈ ਵੀ ਆਊਟਬਾਊਂਡ-ਕਾਲਿੰਗ ਪੁਸ਼ਟੀ ਪੂਰੀ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ।

place_call ਤੱਕ ਪਹੁੰਚ ਵਾਲੇ ਕਲਾਇੰਟ ਨੂੰ ਪ੍ਰੋਡਕਸ਼ਨ ਕਾਲਰ ਸਮਝੋ। ਕਲਾਇੰਟ ਕੌਣ ਵਰਤ ਸਕਦਾ ਹੈ ਇਸਨੂੰ ਸੀਮਿਤ ਕਰੋ, ਇਸਦੇ ਆਪਣੇ prompt ਵਿੱਚ ਲੋੜੀਂਦੇ ਏਜੰਟ ਅਤੇ ਨੰਬਰ ਨੂੰ ਸਪੱਸ਼ਟ ਰੱਖੋ, ਅਤੇ ਕਾਲ ਇਤਿਹਾਸ ਵਿੱਚ ਕਾਲਾਂ ਦੀ ਸਮੀਖਿਆ ਕਰੋ।

ਪੂਰਾ ਵਾਇਰ ਰੈਫਰੈਂਸ

ਜਵਾਬ ਉਦਾਹਰਨਾਂ, JSON-RPC ਗਲਤੀਆਂ ਅਤੇ ਰਿਮੋਟ-ਸਰਵਰ ਪ੍ਰਬੰਧਨ API ਲਈ MCP ਸਰਵਰ API ਦੇਖੋ।