Documentation

What is Thousand API

Thousand API is a utility MCP server for AI agents. It provides tools that solve tasks AI can only handle vaguely through reasoning—reliably and quickly.

Key features:

• Connect directly as an MCP server (Claude and Cursor supported)
• Also available as a REST API
• Real-time data, reliable calculations, and side-effect handling
• Deterministic datetime math—timezones, holidays, business days, and cron next-run times
• JSON Schema validation and optional syntax repair for agent-generated JSON
• Text statistics and estimated reading time (Japanese and English)
• URL redirect resolution for short links and affiliate URLs

Create an account

1. Enter your email and password on the Sign up page
2. Your account is created and you are redirected to the dashboard
3. Start immediately on the free plan

Issue an API key

1. Go to the Dashboard
2. Click "Issue API key"
3. Enter a key name (e.g. "Cursor" or "Production")
4. Copy the issued API key (plaintext is shown only on this screen)

Claude Desktop

Add the following to claude_desktop_config.json.

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "thousand-api": {
      "url": "https://mcp.thousand-api.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add the following in Cursor settings (Settings > MCP).

{
  "mcpServers": {
    "thousand-api": {
      "url": "https://mcp.thousand-api.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Other MCP clients

Any MCP client that supports Streamable HTTP transport can connect.

• URL: https://mcp.thousand-api.com/mcp
• Auth: set your API key in the x-api-key header

Authentication

All API requests require the x-api-key header.

curl https://api.thousand-api.com/v1/calendar/holidays \
  -H "x-api-key: YOUR_API_KEY"

Response codes:

Error codes

Error responses use the following format.

{
  "error": "VALIDATION_ERROR",
  "message": "country must be one of: JP, US"
}

Error code list: