Quick Start

Configure the Thordata MCP Server with an API token, connect to the remote MCP endpoint, authenticate requests, and use search, history, and statistics tools.

1

Before you begin, please ensure that you meet the following requirements:

Thordata Account

Register an account to get 1,000 free SERP API requests.

Thordata API Token

Get your API key from the SERP API dashboard.

2

Use the following endpoint to connect to a remote MCP server.

{
  "mcpServers": {
    "thordata": {
      "type": "http",
      "url": "https://mcp.thordata.com/YOUR_API_TOKEN/mcp"
    }
  }
}

Authentication

Supports three methods:

1. Path-based (Recommended): /{YOUR_API_TOKEN}/mcp

2. Authorization Header: Authorization: Bearer YOUR_API_TOKEN

3. Custom Headers: X-Thor-Serp-Token: YOUR_API_TOKEN

Example:

Path-based

curl "https://mcp.thordata.com/your_token/mcp" -d '...'

Authorization Header

curl "https://mcp.thordata.com/mcp" -H "Authorization: Bearer your_token" -d '...'

Custom Headers

curl "https://mcp.thordata.com/mcp" -H "X-Thor-Serp-Token: your_token" -d '...'

Note: The GET / and GET /healthz endpoints do not require authentication.

Tools

1.list_engines

Lists all supported search engines, categories, and resource URIs. Parameters: None

Example: {"name": "list_engines"}

2.search

Execute a SERP search request. Consult the resources located under thor://engines to review the specific parameters for each engine before invoking this tool.

Parameters:

engine (Optional): Engine identifier, e.g., google, google_images, bing_images, duckduckgo.

If not provided, use the engine field in params or the default engine.

params (Required): An engine-specific parameter object; it must match the Schema resource definition of the corresponding engine.

json (Optional): Upstream response format. json->1, json_html->2, html->3.

response_mode (Optional): complete returns a complete response, compact removes common metadata fields. Default: complete

Supported Search Engines (33 total):

Google (25)

Search, Finance, Finance Markets, Flights, Hotels, Images, Jobs, Lens, Local, Maps, News, Patents, Patents Details, Play Search, Play Books, Play Games, Play Movies, Play Product, Scholar, Scholar Author, Scholar Cite, Shopping, Trends, Videos, Web

Bing (6)

Search, Images, Maps, News, Shopping, Videos

Yandex (1)

Search

DuckDuckGo (1)

Search

Example:

{"name": "search", "arguments": {"engine": "google", "params": {"q": "coffee shops", "location": "Austin, TX"}}} 
{"name": "search", "arguments": {"engine": "google", "params": {"q": "weather in London"}}} 
{"name": "search", "arguments": {"engine": "google", "params": {"q": "AAPL stock"}}} 
{"name": "search", "arguments": {"engine": "duckduckgo", "params": {"q": "car"}}} 
{"name": "search", "arguments": {"engine": "bing", "params": {"q": "latest news"}, "response_mode": "compact"}}

Result Types: Answer Box, Organic Results, News, Images, Shopping, Knowledge Cards—automatically detected and formatted by upstream APIs.

3.history

Query SERP usage history. Parameters:

page (Optional): Page number, default 1

page_size (Optional): Page Size (Common values: 20, 50, 100)

search_query(Optional): Filter by Search Keywords

search_engine (Optional): Filter by Search Engine Display Name

status (Optional): Status Filter. Possible values: all, success, error

start_time (Optional): Start Time (Unix Timestamp, seconds)

end_time (Optional): End Time (Unix Timestamp, seconds)

timezone (Optional): Time zone, e.g., Asia/Shanghai or +08:00

Example:

{"name": "history", "arguments": {"page": 1, "page_size": 20}} 
{"name": "history", "arguments": {"search_query": "coffee", "status": "success"}} 
{"name": "history", "arguments": {"start_time": 1700000000, "end_time": 1700100000, "timezone": "Asia/Shanghai"}}

4.statistics

Query SERP usage statistics. Parameters:

start_date (Required): Start Date (YYYY-MM-DD format)

end_date (Required): End date, format YYYY-MM-DD

engines (Optional): Engine filter; a comma-separated string or an array of strings.

timezone (Optional): Time zone offset, e.g., +00:00, +08:00, -05:00

Example:

{"name": "statistics", "arguments": {"start_date": "2025-01-01", "end_date": "2025-01-31"}} 
{"name": "statistics", "arguments": {"start_date": "2025-01-01", "end_date": "2025-01-31", "engines": "google,bing"}} 
{"name": "statistics", "arguments": {"start_date": "2025-01-01", "end_date": "2025-01-31", "timezone": "+08:00"}}

MCP Resources

• Indexed Resources: thor://engines

Returns a list of all engines, their categories, and resource URIs.

• Engine Schema Resources: thor://engines/{engine_key}

Returns the complete parameter schema definition for a specific engine, used to understand the available parameters before invoking the search tool.

HTTP Routing

1. GET / Return Basic Service Information (No Authentication Required)

2. GET /healthz Health Check (No Authentication Required)

3. POST /mcp MCP Protocol Endpoint (Authentication Required)