---
title: "ThunderPhone-ஐ MCP சர்வராகப் பயன்படுத்துங்கள்"
description: "Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code அல்லது வேறு Streamable HTTP MCP கிளையண்டிலிருந்து ThunderPhone குரல் ஏஜென்ட்களை உருவாக்கி, சோதித்து, சரிபார்த்து, இயக்குங்கள்."
---

ThunderPhone ஒரு Streamable HTTP Model Context Protocol சர்வரை பின்வரும் முகவரியில் வழங்குகிறது:

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

இது [தொலைநிலை MCP சர்வரை ஒரு குரல் ஏஜென்டுடன் இணைப்பதன்](/ta/guides/mcp-servers) எதிர்த் திசையாகும்:

| திசை | விளைவு |
| --- | --- |
| தொலைநிலை MCP சர்வர் → ThunderPhone ஏஜென்ட் | ஒரு குரல் ஏஜென்ட் தொலைநிலை சர்வரின் கருவிகளை அழைக்க முடியும். |
| ThunderPhone → உங்கள் MCP கிளையன்ட் | உங்கள் கோடிங் ஏஜென்ட் ThunderPhone-ஐ உருவாக்க, சோதிக்க, இயக்க முடியும். |

## அங்கீகரிக்கவும்

டைரக்டரி கிளையன்ட்களுக்கு இயல்பாக [OAuth](/ta/guides/oauth)-ஐப் பயன்படுத்தவும்: உள்நுழைந்து, ஒரு நிறுவனத்தைத் தேர்ந்தெடுத்து, கோரப்பட்ட அனுமதிகளை அங்கீகரிக்கவும். **நிறுவனம் → API விசைகள் → அங்கீகரிக்கப்பட்ட செயலிகள்** என்பதன் கீழ் அணுகலைத் திரும்பப்பெறவும்.

API விசையுடன் கட்டமைக்கப்பட்ட கிளையன்ட்களுக்கு, **நிறுவனம் → விசைகள்** என்பதன் கீழ் ஒரு `sk_live_` விசையை உருவாக்கி, அதை உங்கள் MCP கிளையன்டில் `THUNDERPHONE_API_KEY` ஆக வழங்கவும். இந்த விசை ஒரு நிறுவனத்துடன் இணைக்கப்பட்டுள்ளது; வேறொரு நிறுவனத்துக்குச் சொந்தமான id கிடைக்கவில்லை என்பதுபோல் செயல்படும்.

<Warning>
  ஒரு `sk_live_` விசையால் நிறுவனத் தரவைப் படிக்கவும், ஏஜென்ட்களை டிப்ளாய் செய்தல், அழைப்புகளை மேற்கொள்ளுதல், எண்களை வாங்குதல், கேம்பெயின்களைத் தொடங்குதல், வளங்களை நீக்குதல் போன்ற தயாரிப்பு நடவடிக்கைகளைச் செய்யவும் முடியும். இதை உலாவி குறியீடு, ரெப்போசிட்டரிகள், ஸ்கிரீன்ஷாட்கள் மற்றும் அரட்டை பதிவுகளிலிருந்து விலக்கி வைக்கவும். உங்கள் கிளையன்டின் ரகசிய சேமிப்பகம் அல்லது சூழல் ஆதரவைப் பயன்படுத்தி, வெளிப்பட்ட விசையை உடனடியாகத் திரும்பப்பெறவும்.
</Warning>

## CLI மற்றும் stdio மாற்றுகள்

[ThunderPhone CLI](/ta/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](/ta/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-இன் உள்ளீட்டு prompt மூலம் விசையை உள்ளிடவும்:

```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`, ரூட்டிங்/லேபிள்/webhook புலங்கள் | — | ஏஜென்ட் ஒதுக்கீடு உட்பட, எண் ரூட்டிங்கைப் புதுப்பிக்கிறது. |
| `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 | தயாரிப்பு மீட்டெடுப்பு வழியாகத் தேடுகிறது. |

### ஒருங்கிணைப்புகள், webhook-கள் மற்றும் தொலைநிலை MCP சர்வர்கள்

| கருவி | முக்கிய ஆர்கியூமென்ட்கள் | குறிப்புரைகள் | இது என்ன செய்கிறது |
| --- | --- | --- | --- |
| `list_integrations` | — | R, I | HTTP செயல்பாட்டு ஒருங்கிணைப்புகளின் பட்டியலை வழங்குகிறது. |
| `create_integration` | `display_name`, செயல்பாட்டு `spec`, விருப்பமான எண்ட்பாயிண்ட் புலங்கள் | — | ஒரு HTTP கருவியை உருவாக்குகிறது. |
| `test_integration` | `url`, விருப்பமான முறை/ஹெடர்கள்/உடல்/நேரமுடிவு | O | வரம்பிடப்பட்ட, SSRF-பாதுகாக்கப்பட்ட சோதனைக் கோரிக்கையை அனுப்புகிறது. |
| `list_webhook_endpoints` | — | R, I | கையொப்பமிடப்பட்ட webhook எண்ட்பாயிண்ட்களின் பட்டியலை வழங்குகிறது. |
| `create_webhook_endpoint` | `label`, `url`, விருப்பமான நிகழ்வுகள்/நிலை | O | கையொப்பமிடப்பட்ட webhook எண்ட்பாயிண்ட்டை உருவாக்குகிறது. |
| `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 எனக் குறிக்கப்பட்ட கருவிகள் மீட்டமைக்க முடியாத ஒன்றை மாற்றுகின்றன அல்லது அகற்றுகின்றன, அல்லது உண்மையான நபர்களை அழைக்கத் தொடங்குகின்றன. அவற்றுக்கு இரண்டு கோரிக்கைகள் தேவை. முதல் கோரிக்கை எதையும் மாற்றாது மற்றும் இதைத் திருப்பும்:

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

பாதிக்கப்படுவது என்ன என்பதை ஏஜென்ட் பயனருக்குக் காட்டி, ஆம் என்று உறுதிப்படுத்தக் கேட்கும். பின்னர் அதே arguments மற்றும் கூடுதலாக `confirmation_token` உடன் கோரிக்கையை மீண்டும் அனுப்பும். ஒரு டோக்கன் 10 நிமிடங்கள் செல்லுபடியாகும்; அது ஒரு நிறுவனம், ஒரு கருவி மற்றும் ஒரே துல்லியமான arguments தொகுப்புக்கு மட்டுமே பொருந்தும். எனவே மூன்று ஏஜென்ட்களை நீக்க மூன்று உறுதிப்படுத்தல்கள் தேவை. `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 பெயர் மற்றும் அதற்காக அறிவிக்கப்பட்ட arguments உடன் `prompts/get` ஐப் பயன்படுத்தவும்.

## வளங்கள்

`resources/list` பொதுவான, கேச் செய்யப்பட்ட குறிப்புகளை வழங்குகிறது:

| URI | உள்ளடக்கம் |
| --- | --- |
| `thunderphone://docs/llms.txt` | பொதுவான ஆவணப்படுத்தல் அட்டவணை. |
| `thunderphone://docs/quickstart` | விரைவுத் தொடக்க Markdown. |
| `thunderphone://pricing` | தற்போதைய பொதுவான விலை நிர்ணய Markdown. |

ஒன்றைப் படிக்க `resources/read` ஐப் பயன்படுத்தவும். பொதுவான பெறுதல்கள் குறுகிய காலவரம்பு, 2 MiB வரம்பு மற்றும் பத்து நிமிட in-process கேச்சைப் பயன்படுத்துகின்றன.

## நெறிமுறை மற்றும் பிழைகள்

சர்வர் `2025-06-18` மற்றும் `2025-03-26` நெறிமுறை பதிப்புகளை ஆதரிக்கிறது; ஆதரிக்கப்படும் கிளையன்ட் பதிப்பை எதிரொலிக்கும், இல்லையெனில் `2025-06-18` ஐத் தேர்ந்தெடுக்கும். இது `initialize`, `ping`, கருவிகள், prompt-கள், வளங்கள் மற்றும் அறிவிப்புகளைச் செயல்படுத்துகிறது. அறிவிப்புகள் `202 Accepted` ஐத் திருப்பும். இந்த நிலையற்ற சர்வர் SSE listener அல்லது session நீக்கலை வழங்காது; எனவே `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` ஐத் திருப்பும். JSON-RPC batch-கள் MCP `2025-06-18` ஆல் ஆதரிக்கப்படுவதில்லை; அவை சுத்தமான `-32600` தவறான-கோரிக்கை பிழையைத் திருப்பும்.