Open in

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

Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code ਜਾਂ ਕਿਸੇ ਹੋਰ Streamable HTTP MCP ਕਲਾਇੰਟ ਤੋਂ ThunderPhone ਵੌਇਸ ਏਜੰਟ ਬਣਾਓ, ਟੈਸਟ ਕਰੋ, ਪ੍ਰਮਾਣਿਤ ਕਰੋ ਅਤੇ ਚਲਾਓ।

ThunderPhone ਇੱਥੇ ਇੱਕ ਸਟ੍ਰੀਮੇਬਲ HTTP ਮਾਡਲ ਕਾਂਟੈਕਸਟ ਪ੍ਰੋਟੋਕੋਲ ਸਰਵਰ ਉਪਲਬਧ ਕਰਵਾਉਂਦਾ ਹੈ:

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

ਇਹ ਕਿਸੇ ਰਿਮੋਟ MCP ਸਰਵਰ ਨੂੰ ਵੌਇਸ ਏਜੰਟ ਨਾਲ ਕਨੈਕਟ ਕਰਨ ਦੇ ਉਲਟ ਦਿਸ਼ਾ ਹੈ:

ਦਿਸ਼ਾ	ਨਤੀਜਾ
ਰਿਮੋਟ MCP ਸਰਵਰ → ThunderPhone ਏਜੰਟ	ਇੱਕ ਵੌਇਸ ਏਜੰਟ ਰਿਮੋਟ ਸਰਵਰ ਦੇ ਟੂਲ ਕਾਲ ਕਰ ਸਕਦਾ ਹੈ।
ThunderPhone → ਤੁਹਾਡਾ MCP ਕਲਾਇੰਟ	ਤੁਹਾਡਾ ਕੋਡਿੰਗ ਏਜੰਟ ThunderPhone ਨੂੰ ਬਣਾ, ਟੈਸਟ ਅਤੇ ਚਲਾ ਸਕਦਾ ਹੈ।

ਪ੍ਰਮਾਣਿਤ ਕਰੋ

ਡਾਇਰੈਕਟਰੀ ਕਲਾਇੰਟਾਂ ਲਈ ਮੂਲ ਰੂਪ ਵਿੱਚ OAuth ਵਰਤੋ: ਸਾਈਨ ਇਨ ਕਰੋ, ਇੱਕ ਸੰਗਠਨ ਚੁਣੋ ਅਤੇ ਮੰਗੀਆਂ ਗਈਆਂ ਇਜਾਜ਼ਤਾਂ ਨੂੰ ਮਨਜ਼ੂਰੀ ਦਿਓ। ਪਹੁੰਚ ਰੱਦ ਕਰਨ ਲਈ ਸੰਗਠਨ → API ਕੁੰਜੀਆਂ → ਅਧਿਕ੍ਰਿਤ ਐਪਾਂ ਵਿੱਚ ਜਾਓ।

API ਕੁੰਜੀ ਨਾਲ ਸੰਰਚਿਤ ਕਲਾਇੰਟਾਂ ਲਈ, ਸੰਗਠਨ → ਕੁੰਜੀਆਂ ਵਿੱਚ ਇੱਕ sk_live_ ਕੁੰਜੀ ਬਣਾਓ ਅਤੇ ਇਸਨੂੰ ਆਪਣੇ MCP ਕਲਾਇੰਟ ਲਈ THUNDERPHONE_API_KEY ਵਜੋਂ ਉਪਲਬਧ ਕਰਵਾਓ। ਇਹ ਕੁੰਜੀ ਇੱਕ ਹੀ ਸੰਗਠਨ ਨਾਲ ਬੰਨ੍ਹੀ ਹੁੰਦੀ ਹੈ; ਕਿਸੇ ਹੋਰ ਸੰਗਠਨ ਦੀ ਮਲਕੀਅਤ ਵਾਲਾ ਪਛਾਣਕਰਤਾ ਨਹੀਂ ਮਿਲਿਆ ਵਾਂਗ ਵਰਤਾਅ ਕਰਦਾ ਹੈ।

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

CLI ਅਤੇ stdio ਵਿਕਲਪ

ThunderPhone CLI ਗੈਰ-ਸੰਬੰਧਿਤ ਸਰਵਰਾਂ ਨੂੰ ਸੁਰੱਖਿਅਤ ਰੱਖਦਿਆਂ ਕਲਾਇੰਟ ਸੰਰਚਨਾ ਲਿਖ ਸਕਦੀ ਹੈ:

npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope user

@thunderphone/mcp ਦੀ ਗਲੋਬਲ ਇੰਸਟਾਲੇਸ਼ਨ ਤੋਂ ਬਾਅਦ, ਉਹੀ ਵਿਕਲਪਾਂ ਨਾਲ thunderphone-mcp setup ਵਰਤੋ। ਸੈਟਅੱਪ Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop ਅਤੇ Windsurf ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ। ਸਿੱਧੇ HTTP ਨੂੰ ਤਰਜੀਹ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ; Desktop stdio ਵਰਤਦਾ ਹੈ।

ਕਿਸੇ ਵੀ stdio-ਸਮਰੱਥ ਕਲਾਇੰਟ ਲਈ, command: "npx" ਨੂੰ args: ["-y", "@thunderphone/mcp"] ਨਾਲ ਸੰਰਚਿਤ ਕਰੋ। ਰੈਪਰ ਪਹਿਲਾਂ THUNDERPHONE_API_KEY ਵਰਤਦਾ ਹੈ, ਫਿਰ thunderphone login ਤੋਂ ਪ੍ਰਮਾਣ-ਪੱਤਰ ਵਰਤਦਾ ਹੈ, ਮਿਆਦ ਪੁੱਗੇ ਟੋਕਨ ਰੀਫ੍ਰੈਸ਼ ਕਰਦਾ ਹੈ, ਅਤੇ ਫਿਰ mcp-remote ਰਾਹੀਂ OAuth ਵਰਤਦਾ ਹੈ। ਡਿਵਾਈਸ ਲਾਗਇਨ ਅਤੇ OAuth ਲਈ ਸੰਬੰਧਿਤ API OAuth ਲਾਗੂਕਰਨ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ। API ਕੁੰਜੀ ਵਾਲੇ ਮਾਰਗ ਲਈ ਨਹੀਂ ਹੁੰਦੀ। ਸਿੱਧੀਆਂ HTTP ਸੰਰਚਨਾਵਾਂ CLI ਪ੍ਰਮਾਣ-ਪੱਤਰ ਸਟੋਰ ਨੂੰ ਨਹੀਂ ਪੜ੍ਹਦੀਆਂ; ਡਿਵਾਈਸ ਲਾਗਇਨ ਨੂੰ ਦੁਬਾਰਾ ਵਰਤਣ ਲਈ stdio ਰੈਪਰ ਵਰਤੋ।

ਇਹ ਹੇਠਾਂ ਦਿੱਤੀਆਂ ਹੱਥੋਂ ਕੀਤੀਆਂ ਕਲਾਇੰਟ ਸੰਰਚਨਾਵਾਂ ਦੇ ਵਿਕਲਪ ਹਨ।

ਕਲਾਇੰਟ ਕੌਂਫਿਗਰੇਸ਼ਨ

Claude ਅਤੇ ChatGPT OAuth ਨਾਲ ਸਾਈਨ ਇਨ ਕਰਦੇ ਹਨ; ਕਿਸੇ API ਕੁੰਜੀ ਦੀ ਲੋੜ ਨਹੀਂ ਹੁੰਦੀ। ਜੇ ਤੁਹਾਡਾ ਹਾਲੇ ThunderPhone ਖਾਤਾ ਨਹੀਂ ਹੈ, ਤਾਂ ਸਾਈਨ-ਇਨ ਸਫ਼ੇ ਉੱਤੇ ਖਾਤਾ ਬਣਾਓ ਚੁਣੋ ਅਤੇ ਆਪਣੀ ਈਮੇਲ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨ ਤੋਂ ਬਾਅਦ ਤੁਸੀਂ ਮਨਜ਼ੂਰੀ ਸਕ੍ਰੀਨ ਉੱਤੇ ਵਾਪਸ ਆ ਜਾਓਗੇ।

Claude (ਵੈੱਬ, ਡੈਸਕਟਾਪ ਅਤੇ ਮੋਬਾਈਲ)

ਸੈਟਿੰਗਾਂ → ਕਨੈਕਟਰ ਖੋਲ੍ਹੋ। ਜੇ ਕਨੈਕਟਰ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ThunderPhone ਦਿਖਾਈ ਦਿੰਦਾ ਹੈ, ਤਾਂ ਇਸਨੂੰ ਚੁਣੋ। ਨਹੀਂ ਤਾਂ ਕਸਟਮ ਕਨੈਕਟਰ ਸ਼ਾਮਲ ਕਰੋ ਚੁਣੋ, ਇਸਦਾ ਨਾਮ ThunderPhone ਰੱਖੋ ਅਤੇ https://api.thunderphone.com/v1/mcp ਦਰਜ ਕਰੋ।
ਕਨੈਕਟ ਕਰੋ ਚੁਣੋ, ThunderPhone ਵਿੱਚ ਸਾਈਨ ਇਨ ਕਰੋ, ਸੰਗਠਨ ਚੁਣੋ ਅਤੇ ਅਨੁਮਤੀਆਂ ਮਨਜ਼ੂਰ ਕਰੋ।
ਚੈਟ ਵਿੱਚ, ਟੂਲਜ਼ ਮੀਨੂ ਤੋਂ ThunderPhone ਯੋਗ ਕਰੋ ਅਤੇ ਆਪਣੀ ਲੋੜ ਬਾਰੇ ਪੁੱਛੋ, ਉਦਾਹਰਨ ਲਈ "ਮੇਰੇ ਏਜੰਟਾਂ ਦੀ ਸੂਚੀ ਦਿਓ"।

ਕਸਟਮ ਕਨੈਕਟਰਾਂ ਲਈ ਭੁਗਤਾਨ ਕੀਤਾ Claude ਪਲਾਨ ਚਾਹੀਦਾ ਹੈ। Team ਅਤੇ Enterprise ਪਲਾਨਾਂ ਵਿੱਚ, ਮਾਲਕ ਪਹਿਲਾਂ ਸੰਗਠਨ ਦੀਆਂ ਕਨੈਕਟਰ ਸੈਟਿੰਗਾਂ ਹੇਠ ਕਨੈਕਟਰ ਸ਼ਾਮਲ ਕਰਦਾ ਹੈ, ਫਿਰ ਹਰ ਮੈਂਬਰ ਆਪਣਾ ThunderPhone ਖਾਤਾ ਕਨੈਕਟ ਕਰਦਾ ਹੈ।

ChatGPT

ਜੇ ChatGPT ਐਪ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ThunderPhone ਦਿਖਾਈ ਦਿੰਦਾ ਹੈ, ਤਾਂ ਇਸਨੂੰ ਚੁਣੋ ਅਤੇ ਕਨੈਕਟ ਕਰੋ।
ਨਹੀਂ ਤਾਂ ਸੈਟਿੰਗਾਂ → ਐਪਾਂ ਅਤੇ ਕਨੈਕਟਰ → ਉੱਨਤ ਸੈਟਿੰਗਾਂ ਖੋਲ੍ਹੋ, ਡਿਵੈਲਪਰ ਮੋਡ ਚਾਲੂ ਕਰੋ ਅਤੇ https://api.thunderphone.com/v1/mcp URL ਅਤੇ OAuth ਪ੍ਰਮਾਣੀਕਰਨ ਨਾਲ ਇੱਕ ਕਨੈਕਟਰ ਬਣਾਓ।
ThunderPhone ਵਿੱਚ ਸਾਈਨ ਇਨ ਕਰੋ, ਸੰਗਠਨ ਚੁਣੋ ਅਤੇ ਅਨੁਮਤੀਆਂ ਮਨਜ਼ੂਰ ਕਰੋ। ਟੂਲਜ਼ ਮੀਨੂ ਤੋਂ ThunderPhone ਨੂੰ ਚੈਟ ਵਿੱਚ ਸ਼ਾਮਲ ਕਰੋ।

ਏਜੰਟ ਜਾਂ ਫ਼ੋਨ ਨੰਬਰ ਮਿਟਾਉਣ, ਡਰਾਫਟ ਰੱਦ ਕਰਨ ਅਤੇ ਮੁਹਿੰਮ ਸ਼ੁਰੂ ਕਰਨ ਲਈ ਕਿਸੇ ਵੀ ਐਪ ਵਿੱਚ ਦੂਜੀ ਪੁਸ਼ਟੀ ਮੰਗੀ ਜਾਂਦੀ ਹੈ; ਵਿਨਾਸ਼ਕਾਰੀ ਕਾਰਵਾਈਆਂ ਦੀ ਪੁਸ਼ਟੀ ਵੇਖੋ।

Claude Code

claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
  --header "Authorization: Bearer $THUNDERPHONE_API_KEY"

Codex

ਇਸਨੂੰ ~/.codex/config.toml ਵਿੱਚ ਸ਼ਾਮਲ ਕਰੋ:

[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"

Cursor

.cursor/mcp.json ਬਣਾਓ:

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

Claude Desktop

Claude Desktop ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਿੱਚ ਇੱਕ mcp-remote ਬ੍ਰਿਜ ਸ਼ਾਮਲ ਕਰੋ:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.thunderphone.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${THUNDERPHONE_API_KEY}"
      ],
      "env": {
        "THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
      }
    }
  }
}

VS Code

.vscode/mcp.json ਬਣਾਓ ਅਤੇ VS Code ਦੇ ਇਨਪੁੱਟ ਪ੍ਰੋਂਪਟ ਰਾਹੀਂ ਕੁੰਜੀ ਦਰਜ ਕਰੋ:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "thunderphone-api-key",
      "description": "ThunderPhone organization API key",
      "password": true
    }
  ],
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:thunderphone-api-key}"
      }
    }
  }
}

ਟੂਲ

ਹਰ ਟੂਲ ਵਿੱਚ MCP ਐਨੋਟੇਸ਼ਨ ਹੁੰਦੇ ਹਨ। ਟੇਬਲਾਂ ਵਿੱਚ, R ਦਾ ਅਰਥ ਸਿਰਫ਼-ਪੜ੍ਹਨਯੋਗ, D ਵਿਨਾਸ਼ਕਾਰੀ, I ਆਇਡੈਂਪੋਟੈਂਟ, ਅਤੇ O ਓਪਨ-ਵਰਲਡ/ਨੈੱਟਵਰਕ ਇੰਟਰੈਕਸ਼ਨ ਹੈ। ਡੈਸ਼ ਦਾ ਅਰਥ ਹੈ ਕਿ ਕੋਈ ਸੰਕੇਤ ਸੈੱਟ ਨਹੀਂ ਹੈ।

ਏਜੰਟ

ਟੂਲ	ਮੁੱਖ ਆਰਗੂਮੈਂਟ	ਐਨੋਟੇਸ਼ਨ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_agents`	—	R, I	ਏਜੰਟਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`get_agent`	`agent_id`	R, I	ਇੱਕ ਏਜੰਟ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`create_agent`	ਏਜੰਟ ਕੌਂਫਿਗਰੇਸ਼ਨ	—	ਇੱਕ ਏਜੰਟ ਬਣਾਉਂਦਾ ਹੈ।
`update_agent`	`agent_id`, ਬਦਲੇ ਹੋਏ ਫੀਲਡ	—	ਏਜੰਟ ਡਰਾਫਟ ਵਿੱਚ ਫੀਲਡ ਸਟੇਜ ਕਰਦਾ ਹੈ।
`deploy_agent`	`agent_id`, ਵਿਕਲਪਿਕ `if_updated_at`	I	ਡਰਾਫਟ ਨੂੰ ਪ੍ਰੋਡਕਸ਼ਨ ਵਿੱਚ ਪ੍ਰਮੋਟ ਕਰਦਾ ਹੈ।
`discard_agent_draft`	`agent_id`, ਵਿਕਲਪਿਕ `if_updated_at`, ਦੂਜੀ ਬੇਨਤੀ ਵਿੱਚ `confirmation_token`	D, I	ਸਟੇਜ ਕੀਤੀਆਂ ਤਬਦੀਲੀਆਂ ਰੱਦ ਕਰਦਾ ਹੈ। ਦੋ-ਪੜਾਅ ਵਾਲਾ; ਵਿਨਾਸ਼ਕਾਰੀ ਕਾਰਵਾਈਆਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨਾ ਵੇਖੋ।
`duplicate_agent`	`agent_id`, ਵਿਕਲਪਿਕ `name`	—	ਸੰਗਠਨ ਦੇ ਅੰਦਰ ਇੱਕ ਏਜੰਟ ਦੀ ਕਾਪੀ ਬਣਾਉਂਦਾ ਹੈ।
`delete_agent`	`agent_id`, ਦੂਜੀ ਬੇਨਤੀ ਵਿੱਚ `confirmation_token`	D, I	ਇੱਕ ਏਜੰਟ ਨੂੰ ਸਥਾਈ ਤੌਰ 'ਤੇ ਮਿਟਾਉਂਦਾ ਹੈ। ਦੋ-ਪੜਾਅ ਵਾਲਾ।
`list_agent_versions`	`agent_id`	R, I	ਡਿਪਲੌਇ ਕੀਤੇ ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਰਜਨਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।

ਫ਼ੋਨ ਨੰਬਰ ਅਤੇ ਕੈਰੀਅਰ

ਟੂਲ	ਮੁੱਖ ਆਰਗੂਮੈਂਟ	ਐਨੋਟੇਸ਼ਨ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_phone_numbers`	—	R, I	ਸੰਗਠਨ ਦੇ ਨੰਬਰਾਂ ਅਤੇ ਰੂਟਿੰਗ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`get_phone_number_limits`	—	R, I	ਪ੍ਰਬੰਧਿਤ ਨੰਬਰਾਂ ਦੀ ਵਰਤੋਂ ਅਤੇ ਸੀਮਾਵਾਂ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`provision_phone_number`	ਵਿਕਲਪਿਕ `area_code`, `city`, `state`, `idempotency_key`	O	ThunderPhone-ਪ੍ਰਬੰਧਿਤ ਇਨਬਾਊਂਡ ਨੰਬਰ ਖਰੀਦਦਾ ਹੈ।
`list_voip_connections`	—	R, I	ਕਨੈਕਟ ਕੀਤੇ ਗਾਹਕ ਕੈਰੀਅਰਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`search_voip_numbers`	`connection_id`, `country`, `type`, ਵਿਕਲਪਿਕ `area_code`	R, I, O	ਕੈਰੀਅਰ ਇਨਵੈਂਟਰੀ ਵਿੱਚ ਖੋਜ ਕਰਦਾ ਹੈ।
`import_voip_numbers`	`connection_id`, `numbers`	O	ਕੈਰੀਅਰ 'ਤੇ ਪਹਿਲਾਂ ਤੋਂ ਮਲਕੀਅਤ ਵਾਲੇ ਨੰਬਰ ਇੰਪੋਰਟ ਕਰਦਾ ਹੈ।
`update_phone_number`	`phone_number_id`, ਰੂਟਿੰਗ/ਲੇਬਲ/ਵੈੱਬਹੁੱਕ ਫੀਲਡ	—	ਏਜੰਟ ਅਸਾਈਨਮੈਂਟ ਸਮੇਤ ਨੰਬਰ ਰੂਟਿੰਗ ਅੱਪਡੇਟ ਕਰਦਾ ਹੈ।
`delete_phone_number`	`phone_number_id`, `confirm`, ਵਿਕਲਪਿਕ `release_at_provider`, ਦੂਜੀ ਬੇਨਤੀ ਵਿੱਚ `confirmation_token`	D, I, O	ਇੱਕ ਨੰਬਰ ਰਿਲੀਜ਼ ਕਰਦਾ ਹੈ। ਦੋ-ਪੜਾਅ ਵਾਲਾ।

ਕਾਲਾਂ

ਟੂਲ	ਮੁੱਖ ਆਰਗੂਮੈਂਟ	ਐਨੋਟੇਸ਼ਨ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_calls`	ਵਿਕਲਪਿਕ ਫਿਲਟਰ, `limit`, `offset`	R, I	REST ਕਾਲ-ਹਿਸਟਰੀ ਫਿਲਟਰਾਂ ਨਾਲ ਕਾਲਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`get_call`	`call_id`	R, I	ਕਾਲ ਸਥਿਤੀ ਅਤੇ ਮੈਟਾਡੇਟਾ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`get_call_transcript`	`call_id`, ਵਿਕਲਪਿਕ `live`	R, I	ਕਾਲ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`get_call_audio_url`	`call_id`, ਵਿਕਲਪਿਕ `download`	R, I, O	ਇੱਕ ਸਾਈਨ ਕੀਤਾ ਆਡੀਓ URL ਵਾਪਸ ਕਰਦਾ ਹੈ; ਇਹ ਕਦੇ ਵੀ MCP ਰਾਹੀਂ ਆਡੀਓ ਸਟ੍ਰੀਮ ਨਹੀਂ ਕਰਦਾ।
`get_call_grade`	`call_id`	R, I	ਨਵਾਂਤਮ ਕਾਲ ਗ੍ਰੇਡ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`place_call`	`agent_id`, `from_number`, `to_number`	O	ਇੱਕ ਗੈਰ-ਆਇਡੈਂਪੋਟੈਂਟ ਆਊਟਬਾਊਂਡ ਕਾਲ ਕਰਦਾ ਹੈ।
`export_calls`	ਕਾਲ ਫਿਲਟਰ, `export_format`	R, I	REST ਐਂਡਪੁਆਇੰਟ ਦੀ ਸੀਮਾ ਤੱਕ JSON ਜਾਂ CSV ਵਜੋਂ ਐਕਸਪੋਰਟ ਕਰਦਾ ਹੈ।

ਟੈਸਟਿੰਗ ਅਤੇ ਵੈਲੀਡੇਸ਼ਨ

ਟੂਲ	ਮੁੱਖ ਆਰਗੂਮੈਂਟ	ਐਨੋਟੇਸ਼ਨ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_test_scenarios`	`agent_id`	R, I	ਟੈਸਟ ਸਿਨਾਰਿਓ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`create_test_scenario`	`agent_id`, `title`, `scenario_prompt`, ਵਿਕਲਪਿਕ ਸ਼ਰਤਾਂ	—	ਇੱਕ ਸਿਨਾਰਿਓ ਬਣਾਉਂਦਾ ਹੈ।
`generate_test_scenarios`	`agent_id`, ਵਿਕਲਪਿਕ `count`, `include_edge_cases`, `locale`	O	ਏਜੰਟ prompt ਤੋਂ ਸਿਨਾਰਿਓ ਤਿਆਰ ਕਰਦਾ ਹੈ।
`run_agent_tests`	`agent_id`, `channel`, `consent_to_charge`, ਵਿਕਲਪਿਕ ਚੋਣ/ਮੈਟ੍ਰਿਕਸ	O	ਵੈੱਬ ਜਾਂ ਟੈਲੀਫੋਨੀ ਰਾਹੀਂ ਸਿਨਾਰਿਓ ਚਲਾਉਂਦਾ ਹੈ।
`get_test_run`	`agent_id`, `batch_id`	R, I	ਬੈਚ ਸਥਿਤੀ ਅਤੇ ਪ੍ਰਤੀ-ਸਿਨਾਰਿਓ ਨਤੀਜੇ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`list_validation_runs`	`agent_id`	R, I	ਹਾਲੀਆ ਡਰਾਫਟ ਵੈਲੀਡੇਸ਼ਨ ਰਨ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`get_validation_status`	`agent_id`	R, I	ਨਵਾਂਤਮ ਵੈਲੀਡੇਸ਼ਨ ਸਥਿਤੀ ਅਤੇ ਡਰਾਫਟ ਮੇਲ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।

ਗਿਆਨ

ਟੂਲ	ਮੁੱਖ ਆਰਗੂਮੈਂਟ	ਐਨੋਟੇਸ਼ਨ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_knowledge_bases`	—	R, I	ਗਿਆਨ ਅਧਾਰਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`create_knowledge_base`	`name`, ਵਿਕਲਪਿਕ `description`	—	ਇੱਕ ਗਿਆਨ ਅਧਾਰ ਬਣਾਉਂਦਾ ਹੈ।
`add_knowledge_document`	`knowledge_base_id`, `name`, `content`	—	ਟੈਕਸਟ ਜਾਂ Markdown ਜੋੜਦਾ ਹੈ।
`import_knowledge_url`	`url`, ਵਿਕਲਪਿਕ `name`	O	ਸੁਰੱਖਿਅਤ ਇੰਜੈਸ਼ਨ ਲਈ ਇੱਕ ਜਨਤਕ ਪੰਨੇ ਨੂੰ ਕਤਾਰਬੱਧ ਕਰਦਾ ਹੈ।
`search_knowledge`	`knowledge_base_id`, `query`	R, I	ਪ੍ਰੋਡਕਸ਼ਨ ਰਿਟਰੀਵਲ ਰਾਹੀਂ ਖੋਜ ਕਰਦਾ ਹੈ।

ਇੰਟੀਗ੍ਰੇਸ਼ਨ, ਵੈੱਬਹੁੱਕ ਅਤੇ ਰਿਮੋਟ MCP ਸਰਵਰ

ਟੂਲ	ਮੁੱਖ ਆਰਗੂਮੈਂਟ	ਐਨੋਟੇਸ਼ਨ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_integrations`	—	R, I	HTTP ਫੰਕਸ਼ਨ ਇੰਟੀਗ੍ਰੇਸ਼ਨਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`create_integration`	`display_name`, ਫੰਕਸ਼ਨ `spec`, ਵਿਕਲਪਿਕ ਐਂਡਪੁਆਇੰਟ ਫੀਲਡ	—	ਇੱਕ HTTP ਟੂਲ ਬਣਾਉਂਦਾ ਹੈ।
`test_integration`	`url`, ਵਿਕਲਪਿਕ ਮੈਥਡ/ਹੈਡਰ/ਬਾਡੀ/ਟਾਈਮਆਊਟ	O	ਸੀਮਿਤ, SSRF-ਸੁਰੱਖਿਅਤ ਟੈਸਟ ਬੇਨਤੀ ਭੇਜਦਾ ਹੈ।
`list_webhook_endpoints`	—	R, I	ਸਾਈਨ ਕੀਤੇ ਵੈੱਬਹੁੱਕ ਐਂਡਪੁਆਇੰਟਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`create_webhook_endpoint`	`label`, `url`, ਵਿਕਲਪਿਕ ਇਵੈਂਟ/ਸਥਿਤੀ	O	ਇੱਕ ਸਾਈਨ ਕੀਤਾ ਵੈੱਬਹੁੱਕ ਐਂਡਪੁਆਇੰਟ ਬਣਾਉਂਦਾ ਹੈ।
`test_webhook_endpoint`	`endpoint_id`	O	ਆਮ ਡਿਲੀਵਰੀ ਰਾਹੀਂ ਇੱਕ ਸਿੰਥੈਟਿਕ ਇਵੈਂਟ ਭੇਜਦਾ ਹੈ।
`list_mcp_servers`	—	R, I	ਵੌਇਸ ਏਜੰਟਾਂ ਦੁਆਰਾ ਕਾਲ ਕੀਤੇ ਜਾ ਸਕਣ ਵਾਲੇ ਰਿਮੋਟ ਸਰਵਰਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`create_mcp_server`	`display_name`, `url`, ਵਿਕਲਪਿਕ ਹੈਡਰ	O	ਇੱਕ ਰਿਮੋਟ ਸਰਵਰ ਰਜਿਸਟਰ ਅਤੇ ਸਿੰਕ ਕਰਦਾ ਹੈ।
`sync_mcp_server_tools`	`server_id`	O	ਰਿਮੋਟ ਸਰਵਰ ਦਾ ਟੂਲ ਕੈਟਾਲਾਗ ਰਿਫ੍ਰੈਸ਼ ਕਰਦਾ ਹੈ।

ਕੈਂਪੇਨ

ਟੂਲ	ਮੁੱਖ ਆਰਗੂਮੈਂਟ	ਐਨੋਟੇਸ਼ਨ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_campaigns`	—	R, I	ਆਊਟਬਾਊਂਡ ਕੈਂਪੇਨਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`create_campaign`	ਕੈਂਪੇਨ ਫੀਲਡ	—	ਇੱਕ ਡਰਾਫਟ ਕੈਂਪੇਨ ਬਣਾਉਂਦਾ ਹੈ।
`add_campaign_contacts`	`campaign_id`, `contacts`	—	5,000 ਤੱਕ JSON ਸੰਪਰਕ ਜੋੜਦਾ ਹੈ।
`campaign_action`	`campaign_id`, `action`, ਵਿਕਲਪਿਕ `consent_to_charge`, ਦੂਜੀ ਬੇਨਤੀ ਵਿੱਚ `confirmation_token`	D, O	`start`, `pause`, `resume`, ਜਾਂ `stop` ਚਲਾਉਂਦਾ ਹੈ। `start` ਅਤੇ `resume` ਦੋ-ਪੜਾਅ ਵਾਲੇ ਹਨ; `pause` ਅਤੇ `stop` ਤੁਰੰਤ ਚੱਲਦੇ ਹਨ।
`get_campaign_stats`	`campaign_id`	R, I	ਕਾਊਂਟਰ ਅਤੇ ਹਾਲੀਆ ਨਤੀਜੇ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।

ਆਵਾਜ਼ਾਂ, ਬਿਲਿੰਗ, ਇੰਪੋਰਟ ਅਤੇ ਦਸਤਾਵੇਜ਼

ਟੂਲ	ਮੁੱਖ ਆਰਗੂਮੈਂਟ	ਐਨੋਟੇਸ਼ਨ	ਇਹ ਕੀ ਕਰਦਾ ਹੈ
`list_voices`	—	R, I	ਆਵਾਜ਼ਾਂ ਅਤੇ ਸਮਰਥਿਤ ਭਾਸ਼ਾਵਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`preview_voice`	`voice`, `language`, `text`	O	ਇੱਕ ਨਮੂਨਾ ਤਿਆਰ ਕਰਦਾ ਹੈ ਅਤੇ ਸਾਈਨ ਕੀਤਾ URL ਵਾਪਸ ਕਰਦਾ ਹੈ।
`list_voice_clones`	—	R, I	ਕਸਟਮ ਵੌਇਸ ਕਲੋਨਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ।
`get_billing_summary`	—	R, I	ਬਕਾਇਆ ਅਤੇ ਅਧਿਕਾਰਤ ਟੀਅਰ ਕੀਮਤਾਂ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ; ਕੋਈ ਭੁਗਤਾਨ ਤਬਦੀਲੀ ਉਪਲਬਧ ਨਹੀਂ ਕਰਵਾਈ ਜਾਂਦੀ।
`create_agent_import`	`vendor`, `vendor_key`	O	ਇੱਕ ਇਨਕ੍ਰਿਪਟ ਕੀਤਾ Vapi, Retell, ElevenLabs, ਜਾਂ Bland ਇੰਪੋਰਟ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ।
`get_agent_import`	`public_id`	R, I	ਪ੍ਰਸਤਾਵਿਤ ਇੰਪੋਰਟ ਡਿਫ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
`commit_agent_import`	`public_id`	—	ਸਮੀਖਿਆ ਕੀਤੀ ਯੋਜਨਾ ਵਿੱਚੋਂ ਚੁਣੇ ਹੋਏ ਏਜੰਟ ਕਮਿਟ ਕਰਦਾ ਹੈ।
`search_docs`	`query`, ਵਿਕਲਪਿਕ `limit`	R, I, O	ਜਨਤਕ ਦਸਤਾਵੇਜ਼ ਇੰਡੈਕਸ ਵਿੱਚ ਖੋਜ ਕਰਦਾ ਹੈ।
`get_doc_page`	`path`	R, I, O	ਇੱਕ ਜਨਤਕ Markdown ਦਸਤਾਵੇਜ਼ ਪੰਨਾ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।

ਸਾਰੇ ਉਤਪਾਦ ਟੂਲ ਜਨਤਕ API ਵਾਂਗ ਹੀ REST ਕੋਡ ਪਾਥ ਵਰਤਦੇ ਹਨ। ਇਸ ਲਈ REST ਵੈਲੀਡੇਸ਼ਨ, ਸੰਗਠਨ ਸਕੋਪਿੰਗ, ਭੂਮਿਕਾਵਾਂ, ਬਿਲਿੰਗ ਦਾਖਲਾ, ਕੋਟੇ, TCPA ਪੁਸ਼ਟੀ, ਪ੍ਰੋਵਾਈਡਰ ਸੁਰੱਖਿਆ ਅਤੇ ਆਡਿਟ ਵਿਹਾਰ ਬਿਨਾਂ ਤਬਦੀਲੀ ਲਾਗੂ ਹੁੰਦੇ ਹਨ।

ਵਿਨਾਸ਼ਕਾਰੀ ਕਾਰਵਾਈਆਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨਾ

D ਨਾਲ ਚਿੰਨ੍ਹਿਤ ਟੂਲ ਅਜਿਹੀ ਚੀਜ਼ ਬਦਲਦੇ ਜਾਂ ਹਟਾਉਂਦੇ ਹਨ ਜਿਸ ਨੂੰ ਮੁੜ ਬਹਾਲ ਨਹੀਂ ਕੀਤਾ ਜਾ ਸਕਦਾ, ਜਾਂ ਅਸਲ ਲੋਕਾਂ ਨੂੰ ਡਾਇਲ ਕਰਨਾ ਸ਼ੁਰੂ ਕਰਦੇ ਹਨ। ਇਨ੍ਹਾਂ ਲਈ ਦੋ ਬੇਨਤੀਆਂ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ। ਪਹਿਲੀ ਬੇਨਤੀ ਕੋਈ ਤਬਦੀਲੀ ਨਹੀਂ ਕਰਦੀ ਅਤੇ ਇਹ ਵਾਪਸ ਕਰਦੀ ਹੈ:

{
  "status": "confirmation_required",
  "action": "Delete agent",
  "target": { "id": 195, "name": "Front Desk Receptionist" },
  "confirmation_token": "…",
  "expires_in_seconds": 600,
  "next_step": "…"
}

ਸਹਾਇਕ ਵਰਤੋਂਕਾਰ ਨੂੰ ਦਿਖਾਉਂਦਾ ਹੈ ਕਿ ਕੀ ਪ੍ਰਭਾਵਿਤ ਹੋਵੇਗਾ ਅਤੇ ਹਾਂ ਲਈ ਪੁੱਛਦਾ ਹੈ। ਫਿਰ ਇਹ ਉਹੀ ਆਰਗੂਮੈਂਟਾਂ ਦੇ ਨਾਲ confirmation_token ਜੋੜ ਕੇ ਬੇਨਤੀ ਦੁਹਰਾਉਂਦਾ ਹੈ। ਟੋਕਨ 10 ਮਿੰਟ ਲਈ ਵੈਧ ਹੁੰਦਾ ਹੈ ਅਤੇ ਇੱਕ ਸੰਸਥਾ, ਇੱਕ ਟੂਲ ਅਤੇ ਆਰਗੂਮੈਂਟਾਂ ਦੇ ਇੱਕ ਸਟੀਕ ਸੈੱਟ ਲਈ ਲਾਗੂ ਹੁੰਦਾ ਹੈ, ਇਸ ਲਈ ਤਿੰਨ ਏਜੰਟ ਮਿਟਾਉਣ ਲਈ ਤਿੰਨ ਪੁਸ਼ਟੀਆਂ ਲੋੜੀਂਦੀਆਂ ਹਨ। pause ਜਾਂ stop ਨਾਲ campaign_action ਇਹ ਕਦਮ ਛੱਡ ਦਿੰਦਾ ਹੈ, ਤਾਂ ਜੋ ਚੱਲ ਰਹੀ ਮੁਹਿੰਮ ਨੂੰ ਹਮੇਸ਼ਾ ਤੁਰੰਤ ਰੋਕਿਆ ਜਾ ਸਕੇ।

ਸ਼ੁਰੂਆਤੀ prompt

prompts/list ਛੇ ਮੁੜ ਵਰਤਣਯੋਗ ਵਰਕਫ਼ਲੋ ਦਿਖਾਉਂਦਾ ਹੈ:

create_inbound_receptionist
run_agent_tests
import_vapi_assistants
buy_and_attach_number
review_low_grade_calls
add_url_to_agent_knowledge

ਚਲਾਉਣ ਲਈ ਤਿਆਰ ਵਰਤੋਂਕਾਰ ਸੁਨੇਹਾ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਸੂਚੀਬੱਧ prompt ਨਾਮ ਅਤੇ ਉਸਦੇ ਘੋਸ਼ਿਤ ਆਰਗੂਮੈਂਟਾਂ ਨਾਲ prompts/get ਵਰਤੋ।

ਸਰੋਤ

resources/list ਜਨਤਕ, ਕੈਸ਼ ਕੀਤੇ ਹਵਾਲੇ ਉਪਲਬਧ ਕਰਵਾਉਂਦਾ ਹੈ:

URI	ਸਮੱਗਰੀ
`thunderphone://docs/llms.txt`	ਜਨਤਕ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਸੂਚਕਾਂਕ।
`thunderphone://docs/quickstart`	ਤੇਜ਼ ਸ਼ੁਰੂਆਤ Markdown।
`thunderphone://pricing`	ਮੌਜੂਦਾ ਜਨਤਕ ਕੀਮਤਾਂ ਦਾ Markdown।

resources/read ਨਾਲ ਇੱਕ ਪੜ੍ਹੋ। ਜਨਤਕ ਫੈਚ ਛੋਟਾ ਟਾਈਮਆਉਟ, 2 MiB ਸੀਮਾ ਅਤੇ ਪ੍ਰਕਿਰਿਆ ਅੰਦਰ ਦਸ-ਮਿੰਟ ਕੈਸ਼ ਵਰਤਦੇ ਹਨ।

ਪ੍ਰੋਟੋਕੋਲ ਅਤੇ ਗਲਤੀਆਂ

ਸਰਵਰ ਪ੍ਰੋਟੋਕੋਲ ਵਰਜਨ 2025-06-18 ਅਤੇ 2025-03-26 ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ; ਇਹ ਸਮਰਥਿਤ ਕਲਾਇੰਟ ਵਰਜਨ ਨੂੰ ਵਾਪਸ ਭੇਜਦਾ ਹੈ ਅਤੇ ਨਹੀਂ ਤਾਂ 2025-06-18 ਚੁਣਦਾ ਹੈ। ਇਹ initialize, ping, ਟੂਲ, prompt, ਸਰੋਤ ਅਤੇ ਨੋਟੀਫਿਕੇਸ਼ਨ ਲਾਗੂ ਕਰਦਾ ਹੈ। ਨੋਟੀਫਿਕੇਸ਼ਨ 202 Accepted ਵਾਪਸ ਕਰਦੇ ਹਨ। ਇਹ ਸਟੇਟਲੈੱਸ ਸਰਵਰ SSE ਲਿਸਨਰ ਜਾਂ ਸੈਸ਼ਨ ਮਿਟਾਉਣਾ ਉਪਲਬਧ ਨਹੀਂ ਕਰਵਾਉਂਦਾ, ਇਸ ਲਈ GET ਅਤੇ DELETE, Allow: POST ਨਾਲ 405 Method Not Allowed ਵਾਪਸ ਕਰਦੇ ਹਨ।

ਟੂਲ ਅਸਫਲਤਾਵਾਂ isError: true ਨਾਲ ਸਫਲ JSON-RPC ਜਵਾਬ ਹੀ ਰਹਿੰਦੀਆਂ ਹਨ। ਇਨ੍ਹਾਂ ਦੇ ਟੈਕਸਟ ਵਿੱਚ ਇੱਕ ਛੋਟੇ ਵਾਕ ਤੋਂ ਬਾਅਦ JSON ਬਲਾਕ ਹੁੰਦਾ ਹੈ:

{
  "code": "insufficient_balance",
  "detail": "There is not enough prepaid balance.",
  "next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}

ਵੱਖਰਾ outbound_tcpa_confirmation_required: ਪ੍ਰੀਫਿਕਸ place_call ਲਈ ਬਰਕਰਾਰ ਰੱਖਿਆ ਜਾਂਦਾ ਹੈ। ਅਣਜਾਣ JSON-RPC ਵਿਧੀਆਂ HTTP 200 ਜਵਾਬ ਵਿੱਚ -32601 ਵਾਪਸ ਕਰਦੀਆਂ ਹਨ। JSON-RPC ਬੈਚਾਂ ਨੂੰ MCP 2025-06-18 ਸਮਰਥਨ ਨਹੀਂ ਦਿੰਦਾ ਅਤੇ ਇਹ ਸਾਫ਼ -32600 ਅਵੈਧ-ਬੇਨਤੀ ਗਲਤੀ ਵਾਪਸ ਕਰਦੇ ਹਨ।