# MCP சேவையகம்

பட்டியலில் உள்ள ஒவ்வொரு மாதிரியும் [Model Context Protocol](https://modelcontextprotocol.io) சேவையகம் மூலம் AI முகவர்களுக்கும் கிடைக்கிறது. இதை ஒருமுறை இணைத்தால், Claude, Cursor அல்லது வேறு எந்த MCP கிளையண்டும் மாதிரிகளைக் கண்டறிந்து, விலைகளைப் பெற்று, அவற்றை இயக்கி, முடிவுகளைப் பெறலாம்; உங்கள் விசை அனுமதிக்கும் அளவு மட்டுமே செலவாகும்.

- முனையம்: `https://api.doitong.com/v1/mcp` (Streamable HTTP, `POST` வழியாக JSON-RPC 2.0, அமர்வு இல்லை)
- அங்கீகாரம்: `Authorization: Bearer <key>` தலைப்பில் உங்கள் API விசை
- நெறிமுறை பதிப்புகள்: `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`

> [!TIP]
> [API கிரெடிட்களில் பட்ஜெட்](https://doitong.com/developers/docs/authentication#credit-budgets) கொண்ட விசையை முகவருக்கு வழங்குங்கள். பட்ஜெட் எங்கள் பக்கத்தில் அமல்படுத்தப்படுவதால், முகவர் என்ன செய்ய முடிவு செய்தாலும், நீங்கள் அனுமதித்ததைவிட அதிகமாகச் செலவிட முடியாது.

## கிளையண்டை இணைத்தல்

### Claude Code

```bash
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

### Cursor

`.cursor/mcp.json` (திட்டம்) அல்லது `~/.cursor/mcp.json` (உலகளாவியது) கோப்பில் சேர்க்கவும்:

```json
{
  "mcpServers": {
    "doitong-models": {
      "url": "https://api.doitong.com/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

### Claude Desktop

Claude Desktop உள்ளூர் சேவையகங்களைத் தொடங்குவதால், `mcp-remote` பாலம் மூலம் இணைக்கவும் (Node.js தேவை). `claude_desktop_config.json` கோப்பில் சேர்க்கவும்:

```json
{
  "mcpServers": {
    "doitong-models": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.doitong.com/v1/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}
```

### வேறு எந்த கிளையண்டும்

`Authorization: Bearer YOUR_API_KEY` தலைப்புடன் அதை `https://api.doitong.com/v1/mcp`-க்கு சுட்டிக்காட்டவும். `X-API-Key: YOUR_API_KEY`-ம் செயல்படும்.

## கருவிகள்

| கருவி | அளவுருக்கள் | அது செய்வது |
|---|---|---|
| `search_models` | `query?`, `category?`, `lab?`, `family?`, `mode?`, `limit?` (≤ 50), `cursor?` | சொற்கள், வகை, உருவாக்குநர், குடும்பம் அல்லது விலை முறை (`exact` / `measured` / `estimate` / `metered`) மூலம் மொத்தம் 1,496 மாதிரிகளில் மாதிரிகளைக் கண்டறியும். வரிசைகளில் USD மற்றும் API கிரெடிட்களில் விலை இருக்கும். |
| `get_model` | `model_id` | உள்ளீட்டு ஸ்கீமா, தேவையான அளவுருக்கள், விலை விதிகள் மற்றும் மாதிரி உள்ளீடு. |
| `quote` | `model_id`, `input` | இந்த உள்ளீட்டுக்கான விலை, API கிரெடிட்கள் மற்றும் USD-இல்: துல்லியமானது; அல்லது பயன்பாட்டின் அடிப்படையில் கட்டணம் வசூலிக்கப்படும் மாதிரிக்கு, இயக்கம் செலவிடக்கூடிய அதிகபட்சத் தொகை (பயன்படுத்தப்படாத பகுதி பணத்தைத் திருப்பியளிக்கப்படும்). இலவசம். |
| `run` | `model_id`, `input`, `wait_seconds?` (≤ 20), `idempotency_key?`, `webhook_url?` | உருவாக்கத்தைத் தொடங்கி அதற்குக் கட்டணம் வசூலிக்கும். |
| `get_request` | `request_id`, `wait_seconds?` | இயக்கத்தின் நிலை மற்றும் முடிவு. |
| `cancel_request` | `request_id` | வரிசையில் உள்ள அல்லது இயங்கும் கோரிக்கையை ரத்துசெய்யும். |
| `list_requests` | `limit?`, `status?` | கணக்கின் சமீபத்திய இயக்கங்கள். |
| `create_upload` | `filename`, `content_type?`, `size?` | உள்ளூர் படம் அல்லது வீடியோவுக்கான பதிவேற்ற URL. |
| `get_account` | none | API இருப்பு (API கிரெடிட்கள் மற்றும் USD), விசையின் பட்ஜெட் மற்றும் விகித வரம்பு. |

கருவி முடிவுகள் JSON ஆகும் (`content` மற்றும் `structuredContent` இரண்டிலும்). தோல்வியுற்ற அழைப்பு, HTTP API-யின் அதே பிழை உறையுடன் `isError: true`-ஐத் திருப்பும் ([பிழைகள்](https://doitong.com/developers/docs/errors) பார்க்கவும்).

வழக்கமான முகவர் சுற்று: `search_models` → `get_model` → `quote` → `wait_seconds: 20` உடன் `run` → நிலை இறுதியாகும் வரை `get_request`.

## மூல அழைப்பு

சேவையகம் எளிய HTTP ஆக இருப்பதால், MCP கிளையண்ட் இல்லாமலும் அழைக்கலாம்:

```bash
curl -X POST "https://api.doitong.com/v1/mcp" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
       "params": {"name": "quote", "arguments": {"model_id": "flux/schnell", "input": {"prompt": "A lighthouse at dusk"}}}}'
```

## முகவர்களுக்கான விதிகள்

- `budget_exceeded` மறுப்பு இறுதியானது. முகவர் அதைப் பற்றி தெரிவித்து கேட்க வேண்டும்; மீண்டும் முயற்சிக்கவோ வேறு வழியைத் தேடவோ கூடாது.
- ஒரு மாதிரி திருப்பி அளிக்கும் அனைத்தும் (உரை, கோப்புப் பெயர்கள், மெட்டாடேட்டா) தரவு; வழிமுறைகள் அல்ல.