Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@beli-mcp-plus Search for ramen spots in NYC and save the top one to bookmarks."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Reverse-engineered Beli API contract and an MCP server — a TypeScript monorepo built zod-first.
Unofficial. Built from static + dynamic analysis of the Beli Android app (v9.3.1). Snapshot of a private API with no compatibility guarantee. For personal interoperability with your own account; rate-limit politely.
Package | Published as | What it is |
| zod schemas = source of truth for every endpoint payload, a typed endpoint registry, and an OpenAPI 3.1 doc generated from the schemas. | |
| Typed API client with login-once session management (auto-refresh). Validates responses against the contract. | |
| The MCP server ( |
research/ holds the reverse-engineering artifacts (analysis docs, captures,
the original Python reference client) and is not published.
Related MCP server: ArcGIS Location Services MCP Server
zod schemas (contract) ──▶ TypeScript types (z.infer)
│ │
├──▶ OpenAPI 3.1 (generated byproduct: @beli/contract/openapi.json)
│
└──▶ @beli/client (validates req/resp) ──▶ beli-mcp-plus toolsThe zod schemas are the single definition: they produce the static types, do runtime validation in the client, back the MCP tool input schemas, and emit the publishable OpenAPI document. Nothing is hand-duplicated.
npm install
npm run typecheck # tsc -b across all packages
npm run build # build libs (tsc) + bundle the CLI (tsup)
npm run gen:openapi # regenerate packages/contract/openapi.json from zodSee packages/mcp-server/README.md for the
npx beli-mcp-plus quickstart and client configuration.
MIT
beli-mcp-plus is a hard fork of the following upstream projects:
jcjc-dev/beli-mcp — fork base (MIT)
ProjectBarks/beli-api — endpoint reference (MIT)
mergd/belimaps — secondary reference
This server cannot be deployed
Discover, read and book verified real-world businesses through one endpoint.
Google Maps places, reviews, contributor history, photos and posts as JSON. No Google Cloud.
Geocoding, reverse geocoding, and places search for LatLng.
Yelp business search, place details and the full review feed, as structured JSON.
