ドキュメント

Thousand APIとは

Thousand APIは、AIエージェント向けのユーティリティMCPサーバーです。AIが推論で曖昧にしか処理できないことを、確実・高速に解決するツール群を提供します。

主な特徴:

• MCPサーバーとして直接接続可能（Claude・Cursor対応）
• REST APIとしても利用可能
• リアルタイムデータ・確実な計算・副作用処理を提供
• タイムゾーン・祝日・営業日・Cron次回実行など、推論に頼りがちな日時計算を確実に実行
• エージェント生成JSONのパース・JSON Schema検証・構文エラー修復
• テキストの文字数・段落数・推定読了時間（日本語・英語対応）
• URLリダイレクト追跡（短縮URL・アフィリエイトURLの実体確認）

アカウント登録

1. 新規登録ページでメールアドレスとパスワードを入力
2. アカウントが作成されダッシュボードに遷移
3. 無料プランで即座に利用開始可能

APIキーの発行

1. ダッシュボードにアクセス
2. 「APIキーを発行する」をクリック
3. キーの名前を入力（例: "Cursor用"・"本番用"）
4. 発行されたAPIキーをコピー（この画面でのみ平文が表示されます）

Claude Desktop

claude_desktop_config.jsonに以下を追加してください。

設定ファイルの場所:

• 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

Cursorの設定（Settings > MCP）に以下を追加してください。

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

その他のMCPクライアント

Streamable HTTP transportに対応したMCPクライアントであれば接続できます。

• URL: https://mcp.thousand-api.com/mcp
• 認証: x-api-key ヘッダーにAPIキーを設定

認証

すべてのAPIリクエストにx-api-keyヘッダーが必要です。

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

レスポンスコード:

エラーコード

エラーレスポンスは以下の形式で返されます。

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

エラーコード一覧: