---
title: "ThunderPhone‌ను MCP సర్వర్‌గా ఉపయోగించండి"
description: "Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code లేదా మరొక స్ట్రీమబుల్ HTTP MCP క్లయింట్ నుండి ThunderPhone వాయిస్ ఏజెంట్‌లను నిర్మించండి, పరీక్షించండి, ధృవీకరించండి మరియు నిర్వహించండి."
---

ThunderPhone ఇక్కడ Streamable HTTP Model Context Protocol సర్వర్‌ను అందిస్తుంది:

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

ఇది [రిమోట్ MCP సర్వర్‌ను వాయిస్ ఏజెంట్‌కు కనెక్ట్ చేయడం](/te/guides/mcp-servers)కు విరుద్ధ దిశలో పనిచేస్తుంది:

| దిశ | ఫలితం |
| --- | --- |
| రిమోట్ MCP సర్వర్ → ThunderPhone ఏజెంట్ | వాయిస్ ఏజెంట్ రిమోట్ సర్వర్ టూల్‌లను కాల్ చేయగలదు. |
| ThunderPhone → మీ MCP క్లయింట్ | మీ కోడింగ్ ఏజెంట్ ThunderPhoneను రూపొందించగలదు, పరీక్షించగలదు మరియు నిర్వహించగలదు. |

## ప్రామాణీకరించండి

డైరెక్టరీ క్లయింట్ల కోసం డిఫాల్ట్‌గా [OAuth](/te/guides/oauth) ఉపయోగించండి: సైన్ ఇన్ అవండి, ఒక సంస్థను ఎంచుకోండి, అభ్యర్థించిన అనుమతులను ఆమోదించండి. **సంస్థ → API కీలు → అధీకృత యాప్‌లు** కింద యాక్సెస్‌ను రద్దు చేయండి.

API కీతో కాన్ఫిగర్ చేసిన క్లయింట్ల కోసం, **సంస్థ → కీలు** కింద `sk_live_` కీని సృష్టించి, దానిని మీ MCP క్లయింట్‌కు `THUNDERPHONE_API_KEY`గా అందుబాటులో ఉంచండి. కీ ఒకే సంస్థకు అనుసంధానించబడుతుంది; మరో సంస్థకు చెందిన id కనుగొనబడనట్లుగా ప్రవర్తిస్తుంది.

<Warning>
  `sk_live_` కీ సంస్థ డేటాను చదవగలదు మరియు ఏజెంట్లను డిప్లాయ్ చేయడం, కాల్‌లు చేయడం, నంబర్‌లు కొనుగోలు చేయడం, క్యాంపెయిన్‌లు ప్రారంభించడం, వనరులను తొలగించడం వంటి ప్రొడక్షన్ చర్యలను నిర్వహించగలదు. దీన్ని బ్రౌజర్ కోడ్, రిపాజిటరీలు, స్క్రీన్‌షాట్‌లు మరియు చాట్ లాగ్‌లకు దూరంగా ఉంచండి. మీ క్లయింట్ సీక్రెట్ స్టోర్ లేదా ఎన్విరాన్‌మెంట్ మద్దతును ఉపయోగించండి మరియు బహిర్గతమైన కీని వెంటనే రద్దు చేయండి.
</Warning>

## CLI మరియు stdio ప్రత్యామ్నాయాలు

[ThunderPhone CLI](/te/guides/cli) సంబంధం లేని సర్వర్‌లను భద్రపరుస్తూ క్లయింట్ కాన్ఫిగరేషన్‌ను వ్రాయగలదు:

```bash
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](/te/guides/oauth) ద్వారా సైన్ ఇన్ అవుతాయి; API కీ అవసరం లేదు. మీకు ఇంకా ThunderPhone ఖాతా లేకపోతే, సైన్-ఇన్ పేజీలో **ఖాతాను సృష్టించండి** ఎంచుకోండి; మీ ఇమెయిల్‌ను ధృవీకరించిన తర్వాత మీరు ఆమోద స్క్రీన్‌కు తిరిగి వెళ్తారు.

### Claude (వెబ్, డెస్క్‌టాప్ మరియు మొబైల్)

1. **సెట్టింగ్‌లు → కనెక్టర్లు** తెరవండి. కనెక్టర్ డైరెక్టరీలో ThunderPhone కనిపిస్తే, దాన్ని ఎంచుకోండి. లేకపోతే **అనుకూల కనెక్టర్‌ను జోడించండి** ఎంచుకుని, దానికి `ThunderPhone` అని పేరు పెట్టి, `https://api.thunderphone.com/v1/mcp` నమోదు చేయండి.
2. **కనెక్ట్ చేయండి** ఎంచుకుని, ThunderPhoneకు సైన్ ఇన్ అవండి, సంస్థను ఎంచుకుని, అనుమతులను ఆమోదించండి.
3. చాట్‌లో, టూల్స్ మెను నుంచి ThunderPhoneను ప్రారంభించి, మీకు కావాల్సిన దాన్ని అడగండి, ఉదాహరణకు "నా ఏజెంట్లను జాబితా చేయండి".

అనుకూల కనెక్టర్లకు చెల్లింపు Claude ప్లాన్ అవసరం. Team మరియు Enterprise ప్లాన్‌లలో, యజమాని ముందుగా సంస్థ కనెక్టర్ సెట్టింగ్‌లలో కనెక్టర్‌ను జోడిస్తారు; ఆ తర్వాత ప్రతి సభ్యుడు తమ స్వంత ThunderPhone ఖాతాను కనెక్ట్ చేస్తారు.

### ChatGPT

1. ChatGPT యాప్ డైరెక్టరీలో ThunderPhone కనిపిస్తే, దాన్ని ఎంచుకుని కనెక్ట్ చేయండి.
2. లేకపోతే **సెట్టింగ్‌లు → యాప్‌లు & కనెక్టర్లు → అధునాతన సెట్టింగ్‌లు** తెరిచి, **డెవలపర్ మోడ్** ప్రారంభించి, `https://api.thunderphone.com/v1/mcp` URL మరియు OAuth ప్రమాణీకరణతో ఒక కనెక్టర్‌ను సృష్టించండి.
3. ThunderPhoneకు సైన్ ఇన్ అయి, సంస్థను ఎంచుకుని, అనుమతులను ఆమోదించండి. టూల్స్ మెను నుంచి చాట్‌కు ThunderPhoneను జోడించండి.

ఏజెంట్ లేదా ఫోన్ నంబర్‌ను తొలగించడం, డ్రాఫ్ట్‌ను విస్మరించడం, మరియు క్యాంపెయిన్‌ను ప్రారంభించడం కోసం ఏ యాప్‌లోనైనా రెండో నిర్ధారణ అవసరం; [విధ్వంసక చర్యలను నిర్ధారించడం](#confirming-destructive-actions) చూడండి.

### Claude Code

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

### Codex

దీన్ని `~/.codex/config.toml`కు జోడించండి:

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

### Cursor

`.cursor/mcp.json` సృష్టించండి:

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

### Claude Desktop

Claude Desktop కాన్ఫిగరేషన్‌కు ఒక `mcp-remote` బ్రిడ్జ్‌ను జోడించండి:

```json
{
  "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 ఇన్‌పుట్ ప్రాంప్ట్ ద్వారా కీని నమోదు చేయండి:

```json
{
  "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 | స్టేజ్ చేసిన మార్పులను విస్మరిస్తుంది. రెండు దశలు, [విధ్వంసక చర్యలను నిర్ధారించడం](#confirming-destructive-actions) చూడండి. |
| `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` | — | టెక్స్ట్ లేదా మార్క్‌డౌన్‌ను జోడిస్తుంది. |
| `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 | ఒక పబ్లిక్ మార్క్‌డౌన్ డాక్యుమెంట్ పేజీని పొందుతుంది. |

అన్ని ఉత్పత్తి సాధనాలు పబ్లిక్ API వలే అదే REST కోడ్ పాత్‌లను ఉపయోగిస్తాయి. కాబట్టి REST ధృవీకరణ, సంస్థ స్కోపింగ్, పాత్రలు, బిల్లింగ్ అనుమతి, కోటాలు, TCPA నిర్ధారణ, ప్రొవైడర్ భద్రత మరియు ఆడిట్ ప్రవర్తన మార్పులేకుండా వర్తిస్తాయి.

## విధ్వంసక చర్యలను నిర్ధారించడం

D గుర్తు ఉన్న టూల్స్ పునరుద్ధరించలేని దానిని మార్చుతాయి లేదా తొలగిస్తాయి, లేదా నిజమైన వ్యక్తులకు డయలింగ్ ప్రారంభిస్తాయి. వాటికి రెండు అభ్యర్థనలు అవసరం. మొదటి అభ్యర్థన ఏదీ మార్చదు మరియు ఈ క్రింది సమాచారాన్ని అందిస్తుంది:

```json
{
  "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 బ్లాక్ ఉంటుంది:

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

`place_call` కోసం ప్రత్యేకమైన `outbound_tcpa_confirmation_required:` ప్రిఫిక్స్ అలాగే ఉంచబడుతుంది. తెలియని JSON-RPC మెథడ్‌లు HTTP `200` ప్రతిస్పందనలో `-32601`ను తిరిగి పంపుతాయి. MCP `2025-06-18` JSON-RPC బ్యాచ్‌లకు మద్దతు ఇవ్వదు మరియు స్పష్టమైన `-32600` చెల్లని-అభ్యర్థన లోపాన్ని తిరిగి పంపుతుంది.