Developer Platform

One ledger.
Two ways in.

Secure access for teams, developers, and AI tools to live Hong Kong accounting data. Build with the REST API. Analyze in plain English with the remote MCP server.

OAuth 2.0 · PKCE · HMAC webhooks · Consent-scoped MCP

API

API for products.

Sync ERPs, embed AR/AP, automate approvals. Write invoices, bills, quotes, sales and purchase orders where your scopes allow.

  • Company OAuth apps + Developer Portal catalog
  • Per-company M2M Custom Connections
  • Signed HMAC webhooks
MCP

MCP for AI analysis.

Connect Claude, ChatGPT, Cursor or any MCP client to live invoices, bills, and catalog. Strictly read-only, consent-scoped, no write risk.

  • Streamable HTTP, OAuth + DCR + PKCE
  • Read-only tools: invoices, bills, items
  • Company context comes from the token, never the model
Ask your books anything

Plain-English answers,
straight from the ledger.

Connect any MCP-compatible client and query live invoices, bills, and items. Answers come from your live HeyBen data — not a stale export.

HeyBen MCP · Claude
Read-only
Show unpaid invoices over 30 days
tool · list_invoices
→ 14 results · HKD 482,300 outstanding · avg 42 days
Build with the API

Real resources. Real scopes.

OAuth 2.0 with three modes: Custom Connections (per-company M2M), Company OAuth apps, and a Developer Portal app catalog.

Write (scoped)

InvoicesBillsQuotesSales ordersPurchase ordersItems

Read

Credit notesLedger linesBank transactionsWebhooks
POST /v1/invoices200 OK
curl https://api.heyben.ai/v1/invoices \
  -H "Authorization: Bearer $HEYBEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "cnt_8f2",
    "currency": "HKD",
    "line_items": [
      { "item_id": "itm_412", "qty": 2, "unit_price": 1800 }
    ]
  }'
Connect MCP

Four steps. Consent-first.

Any MCP-compatible client works. Tokens carry the company context so the model never guesses.

  1. 01

    Request access

    Get onboarded to the Developer Platform and the MCP preview.

  2. 02

    Consent scopes

    Choose exactly which read tools each connection can see.

  3. 03

    Connect your client

    Point Claude, ChatGPT, Cursor or Windsurf at the HeyBen MCP URL.

  4. 04

    Ask questions

    Query live invoices, bills, and items — safely, in plain English.

Who it's for

One platform. Three jobs.

  • Product teams
    Embed AR/AP into your app — sync invoices, bills, and items with clean OAuth scopes.
  • Accounting firms
    Automate client operations across companies with per-company Custom Connections.
  • AI copilots
    Give models live books through MCP without any risk of writes to the ledger.
[Partner logo]
Case study coming soon.
[Partner logo]
Case study coming soon.
[Partner logo]
Case study coming soon.

Questions

Ready to build on HeyBen?

Get API access and try the MCP preview. Hong Kong-native. Consent-scoped. Audit-ready.