# Remote MCP Server - LLM Integration

# LLM Integration Guide

The Tomba Remote MCP Server provides seamless integration with leading Large Language Models (LLMs) and AI assistants through the standardized Model Context Protocol. This guide covers setup, configuration, and best practices for various LLM platforms.

## Supported LLM Platforms

### **AI Assistants**

| Platform           | Support Level | Transport | Authentication | Real-time |
| ------------------ | ------------- | --------- | -------------- | --------- |
| **Claude Desktop** | ✅ Full       | HTTP/SSE  | API Key        | ✅ Yes    |
| **ChatGPT**        | ✅ Full       | HTTP/SSE  | API Key        | ✅ Yes    |
| **GitHub Copilot** | ✅ Full       | HTTP/SSE  | API Key        | ✅ Yes    |
| **Cursor AI**      | ✅ Full       | HTTP/SSE  | API Key        | ✅ Yes    |
| **Codeium**        | ✅ Full       | HTTP/SSE  | API Key        | ✅ Yes    |

### **Enterprise LLMs**

| Platform          | Support Level | Transport | Authentication | Real-time |
| ----------------- | ------------- | --------- | -------------- | --------- |
| **Azure OpenAI**  | ✅ Full       | HTTP/SSE  | API Key        | ✅ Yes    |
| **Google Gemini** | ✅ Full       | HTTP/SSE  | API Key        | ✅ Yes    |
| **Anthropic API** | ✅ Full       | HTTP/SSE  | API Key        | ✅ Yes    |

## Quick Start Integration

### Claude Desktop Integration

**1. Configuration File**

Create or update your Claude Desktop configuration:

```json
{
    "mcpServers": {
        "tomba": {
            "url": "https://mcp.tomba.io/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_BASE64_TOKEN"
            }
        }
    }
}
```

**2. Verify Connection**

Start Claude Desktop and verify the integration:

```
Human: Can you check if the Tomba MCP server is connected?

Claude: I can see the Tomba Remote MCP server is successfully connected!
Available tools: domain_search, email_finder, email_verifier, and more.
```

### VS Code (GitHub Copilot) Integration

Add to your VS Code settings or `.vscode/mcp.json`:

```jsonc
{
    "inputs": [
        {
            "type": "promptString",
            "id": "tomba-bearer",
            "description": "Tomba bearer token",
            "password": true,
        },
    ],
    "servers": {
        "tomba": {
            "type": "http",
            "url": "https://mcp.tomba.io/mcp",
            "headers": {
                "Authorization": "Bearer ${input:tomba-bearer}",
            },
        },
    },
}
```

### Cursor Integration

Add to your Cursor MCP configuration:

```json
{
    "mcpServers": {
        "tomba": {
            "url": "https://mcp.tomba.io/mcp",
            "transport": "http",
            "headers": {
                "X-Tomba-Key": "ta_your_api_key",
                "X-Tomba-Secret": "ts_your_secret_key"
            }
        }
    }
}
```

### ChatGPT Integration

**1. OpenAI Responses API**

Example of using our MCP server with OpenAI's Responses API:

```bash
curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \
  -d '{
    "model": "gpt-4.1",
    "tools": [
      {
        "type": "mcp",
        "server_label": "tomba-remote-mcp",
        "server_url": "https://mcp.tomba.io/mcp",
        "require_approval": "never",
        "headers": {
          "x-tomba-key": "ta_1234567890abcdef",
          "x-tomba-secret": "ts_xxxx"
        }
      }
    ],
    "input": "Find email addresses for example.com"
  }'
```

### Common Issues

**Connection Refused**

```bash
# Check network connectivity
curl -I https://mcp.tomba.io/mcp

# Verify API credentials
curl -X POST https://mcp.tomba.io/mcp \
  -H "Authorization: Bearer your_key+your_secret" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

**Authentication Errors**

- Verify API key format: `ta_xxxxxxxxxx`
- Verify secret key format: `ts_xxxxxxxxxx`

**Rate Limit Exceeded**

- Check current usage in dashboard
- Implement exponential backoff
- Consider upgrading account plan