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

Enterprise LLMs

Quick Start Integration

Claude Desktop Integration

1. Configuration File

Create or update your Claude Desktop configuration:

Code
 
{
    "mcpServers": {
        "tomba-remote": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "--remote",
                "--endpoint",
                "https://mcp.tomba.io/mcp",
                "--header",
                "x-tomba-key:ta_1234567890abcdef",
                "--header",
                "x-tomba-secret:ts_abcdef1234567890"
            ]
        }
    }
}

2. Verify Connection

Start Claude Desktop and verify the integration:

Code
 
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 5 others.

ChatGPT Integration

1. OpenAI Responses API

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

Code
 
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

Code
 
# 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