Foursquare

@pipeworx/foursquare

Foursquare Places API（2025 places-api.foursquare.com）MCP — カテゴリー、住所、連絡先、評価順の結果を指定して、キーなしで POI を検索できます。

Pipeworx の一部です。AI エージェントを 1879 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、推奨、公開のいずれもされていません。

ツール

• search_places(query?, near?, latitude?, longitude?, radius_m?, categories?, sort?, limit?)
• get_place(fsq_id)
• nearby_places(latitude, longitude, radius_m?, categories?, limit?)

認証

• プラットフォームキー： ゲートウェイの環境変数 PLATFORM_FOURSQUARE_KEY。
• BYO： https://foursquare.com/developers/ で登録後、?_apiKey=<key> を指定します。

Foursquare の無料利用枠では、月あたり 10,000 回の Pro 呼び出しが可能です。

評価は Premium フィールドです（評価を約束する前にお読みください）

Foursquare の 2025 API では、レスポンスフィールドが Pro（デフォルトで返される項目： 名前、カテゴリー、住所、緯度／経度、距離、電話番号、ウェブサイト、ソーシャル情報）と Premium（rating、price、popularity、hours、description、ヒント、 写真）に分かれています。Premium フィールドは fields で指定した場合にのみ返され、いずれかを 指定すると Premium 料金が発生します。1,000 回あたり 18.75 ドルで、無料枠はありません （foursquare.com/pricing、2026-09-19 に確認）。

この費用を一般ユーザーのトラフィックに適用する承認が下りるまで（フリート #2271）、このパックは 内部の呼び出し元に限り Premium フィールドを要求します（ゲートウェイが _internalCaller を注入します）。すべてのレスポンスには rating_included と rating_reason （included ／ not_requested ／ refused_by_vendor）が含まれ、評価がない場合は rating_note も含まれます。そのため、null の評価は「未評価」ではなく、 要求されなかった、またはベンダーによって保留されたことを示します。sort:"RATING" は いずれの場合も Foursquare で有効なため、数値が保留されていても順序は評価順です。全員に 評価を有効にするには、src/index.ts の PREMIUM_FIELDS_PUBLIC を切り替えてください。

プラットフォームアカウントで Premium 課金が有効になるまでは、refused_by_vendor が表示されます。 2026-09-19 の測定では、未課金のプラットフォームキーで Premium フィールドを指定すると、 Foursquare はすべての呼び出しに HTTP 429 を返しました。そのため、ベンダーが拒否した Premium リクエスト（429／402／403）は、 呼び出しを失敗させたり、null が未要求だったかのように扱ったりせず、Pro のみで 1 回再実行して ラベルを付けます。課金が有効になると、最初のリクエストが成功し、再試行は行われません。

データソース

https://places-api.foursquare.com/places — ヘッダー Authorization: Bearer <api_key> と X-Places-Api-Version: 2025-06-17。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "foursquare": {
      "url": "https://gateway.pipeworx.io/foursquare/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/foursquare/mcp の tools/list は、上の表にあるツールに Pipeworx の共有メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で共通のツール群）を 加えたものを返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、 このパック独自のツールとともに、共有ツールがおよそ 30 個表示されます。接続の initialize レスポンスには 正確なスコープが記載されており、その日の状態を確認するうえでの正式な情報源です。

これは意図的な仕様であり、偶発的な多重化ではありません。メタツールを使うことで、このパックが対象としていない質問にも ask_pipeworx を介してカタログ全体を横断して対応できるため、2 つ目の MCP サーバーを追加する必要がありません。現時点では、 メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキストコストが ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが 直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1879 以上のデータソースに接続します。 違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx はどちらからでも すべてのツールにアクセスできます。

MCP クライアントがありませんか？HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/search_places \
  -H 'Content-Type: application/json' \
  -d '{"query":"coffee","near":"San Francisco, CA","sort":"RATING","limit":10}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/search_places を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "foursquare": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-foursquare"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-foursquare

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックのエンドポイントでも、完全なゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Foursquare data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT