ドキュメント

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キーをコピー（この画面でのみ平文が表示されます）

ツールのON/OFF設定

ダッシュボードのMCPツール設定から、使用するツールをカテゴリ単位・ツール単位でON/OFFできます。

不要なツールをOFFにすることで、MCPクライアントへのツール定義の送信TOKEN数を削減できます。

例: 全55ツール → 20ツールに絞ることで約64%のツール定義TOKEN削減が見込まれます。

ツールを絞り込んでTOKENを最適化する

MCPクライアントは接続時にすべてのツール定義を読み込むため、有効なツール数に比例してTOKENを消費します。

用途に応じてツールを絞り込むことで、ツール定義のTOKENコストを大幅に削減できます。

ツール数とTOKEN消費の目安

用途別おすすめ設定

ダッシュボードの「MCPツール設定」からカテゴリ単位・ツール単位でON/OFFを切り替えられます。

→ ダッシュボードを開く

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"
}

エラーコード一覧: