Yelp

mcp-yelp

Yelp MCP — Yelp Fusion API（api.yelp.com/v3）をラップします

Pipeworx の一部です — AI エージェントを1684以上の稼働中データソースにつなぐMCPゲートウェイです。

ツール

ツール	説明
search_businesses	Yelpで地域の店舗やレストランを、検索語と場所を指定して検索します。星評価、レビュー件数、価格、カテゴリ、住所、電話番号を含む一致した店舗を返します。例：search_businesses({ term: "pizza", location: "San Francisco, CA" }).
get_business	Yelpの店舗を、IDまたはエイリアスで指定して詳細情報を取得します。評価、レビュー件数、価格、カテゴリ、住所、電話番号、営業時間、写真、座標を返します。例：get_business({ id: "garaje-san-francisco" }).
get_reviews	⚠️ 上流で不安定 — Yelp Fusionの/reviewsエンドポイントは、正当な店舗であっても、2026年半ば以降ほとんどのIDで404を返しています。レビューに関する問い合わせには、get_business（レビューの抜粋がインラインで含まれる場合があります）またはsearch_businessesを優先してください。get_reviewsを呼び出す必要がある場合は、search_businessesの結果に含まれる暗号化された店舗ID（長い英数字列。例："WavvLdfdP6g8aZTtbBQHTw"）を渡してください。エイリアスやスラッグ（例："garaje-san-francisco"）は確実に404を返します。店舗ごとに最大3件のレビュー抜粋（評価、本文、投稿者、タイムスタンプ）を返します。"limit"は、指定した値にかかわらずYelp側で上限が設定されます。

クイックスタート

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

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

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

https://gateway.pipeworx.io/yelp/mcpのtools/listは、上の表にあるツールに加えて、Pipeworx共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で使えるツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールとともに、共通ツールが約30個リストされます。接続時のinitialize応答には、その時点での正確な範囲が記載されており、当日の最新情報として参照できます。

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

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

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

どちらのURLも、同じゲートウェイと同じ1684以上のデータソースに接続します。違いは、どのパックのツールが直接リストされるかだけです。どちらからでも、ask_pipeworxを通じてすべてのツールを利用できます。

MCP クライアントがない場合：HTTPで呼び出す

このパックでは独自のAPIキー（_apiKey）が必要です。こちらではAPIキーを代理で提供していないため、キーなしで実行できるcurlの例はありません。ツールの情報を確認するには、GET https://gateway.pipeworx.io/v1/tools/search_businessesを使用します。ツールを探すには、{"query":"..."}を指定してPOST https://gateway.pipeworx.io/v1/tools/search_packsを使用します。

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

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

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

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

npx -y @pipeworx/mcp-yelp

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

ask_pipeworxの使用

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

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

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

詳細

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

ライセンス

MIT