Skip to main content
Glama
ek30gold

beli-mcp-plus

by ek30gold
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

beli

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.

Packages

Package

Published as

What it is

packages/contract

@beli/contract

zod schemas = source of truth for every endpoint payload, a typed endpoint registry, and an OpenAPI 3.1 doc generated from the schemas.

packages/client

@beli/client

Typed API client with login-once session management (auto-refresh). Validates responses against the contract.

packages/mcp-server

beli-mcp-plus

The MCP server (npx beli-mcp-plus). Tools for search, reviews, photos, bookmarks, and local drafts.

research/ holds the reverse-engineering artifacts (analysis docs, captures, the original Python reference client) and is not published.

Related MCP server: bach-yelp_business_api

Architecture (zod-first)

zod schemas (contract)  ──▶  TypeScript types  (z.infer)
        │                          │
        ├──▶  OpenAPI 3.1  (generated byproduct: @beli/contract/openapi.json)
        │
        └──▶  @beli/client (validates req/resp)  ──▶  beli-mcp-plus tools

The 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.

Develop

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 zod

Use the server

See packages/mcp-server/README.md for the npx beli-mcp-plus quickstart and client configuration.

License

MIT

Credits

beli-mcp-plus is a hard fork of the following upstream projects:

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Local Business Data MCP Server

    BACH-AI-Tools
    A
    license
    B
    quality
    D
    maintenance
    Enables access to Google Maps business data including search, reviews, photos, and geocoding. Supports searching businesses by location, area, or coordinates, retrieving detailed business information, reviews, and performing reverse geocoding operations.
    13
    MIT

  • travel_mcp

    Skyline-9
    F
    license
    B
    quality
    C
    maintenance
    Enables comprehensive travel and hospitality operations including parallel hotel price comparison, restaurant discovery and reservations, multi-modal transit directions, and cross-platform place reviews.
    20
    1
    -

  • Yandex Eats MCP

    sptmru
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables searching restaurants and menu items, viewing availability and full menus, and managing restaurant carts via the private Yandex.Eats web API, secured with single-user OAuth, without exposing sensitive account or location data.
    8 npm
    MIT