# Developers

> MCP server for business systems in Georgia. One hosted endpoint for the business systems companies in Georgia use. Sign in with OAuth, call typed tools and get structured JSON back.

## MCP endpoint

- URL: `https://waybill.ge/mcp` (Streamable HTTP)
- Sign-in: OAuth 2.1 or API key
- Results: Structured JSON, `{ok, data}` on success and `{ok, code, message}` on an error

Every public page on this site is also served as `text/markdown`: send `Accept: text/markdown` or append `.md` to the path.

## Quick start

1. **Create an account.** Sign up with your email. The Free plan needs no card. https://waybill.ge/signup
2. **Connect a system.** Add RS.GE, Balance.ge or another system under Business integrations. https://waybill.ge/dashboard/integrations (RS.GE setup guide: https://waybill.ge/dashboard/rs-setup-guide)
3. **Add the server to your client.** Follow your client's steps below, then sign in and approve access on waybill.ge.

## Supported clients

Every client signs in with OAuth. You approve access once, on waybill.ge.

- **Claude**: Works in claude.ai, Claude Desktop and Cowork. Search the Claude connectors directory for waybill.ge, or open https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=waybill.ge&connectorUrl=https%3A%2F%2Fwaybill.ge%2Fmcp
- **Claude Code (CLI)**: `claude mcp add --transport http waybill https://waybill.ge/mcp`
- **Codex (OpenAI)**: `codex mcp add waybill --url https://waybill.ge/mcp`, then `codex mcp login waybill`
- **Cursor**: open cursor://anysphere.cursor-deeplink/mcp/install?name=waybill&config=eyJ1cmwiOiJodHRwczovL3dheWJpbGwuZ2UvbWNwIn0= or the web installer https://cursor.com/en/install-mcp?name=waybill&config=eyJ1cmwiOiJodHRwczovL3dheWJpbGwuZ2UvbWNwIn0=, or paste `{"mcpServers": {"waybill": {"url": "https://waybill.ge/mcp"}}}` into Cursor's MCP settings. Not a Cursor Marketplace listing. This is a direct connector to the hosted MCP server.
- **Grok Bot**: ask it in chat: "Add this MCP server: https://waybill.ge/mcp"
- **Other MCP clients**: ChatGPT and any client that supports remote MCP servers. Add the MCP URL as a remote server and sign in with OAuth. If your client cannot use OAuth, create an API key at https://waybill.ge/dashboard/keys and send it as a Bearer token: `Authorization: Bearer rsk_live_...`

## Tools

92 typed tools. Only RS.GE tools change data; every other system is read-only.

### RS.GE

32 tools. Reads and writes. Save, activate, close, cancel, confirm or reject waybills. Save, offset and send e-invoices. Look up taxpayers.

`get_waybill`, `list_seller_waybills`, `list_buyer_waybills`, `find_return_original`, `get_waybill_corrections`, `list_active_drivers`, `save_waybill_draft`, `update_waybill_draft`, `activate_waybill`, `close_waybill`, `correct_waybill`, `send_waybill_to_transporter`, `cancel_waybill`, `confirm_waybill`, `reject_waybill`, `save_invoice_from_waybill`, `save_advance_invoice`, `save_supply_invoice`, `attach_advance_invoice`, `send_invoice`, `correct_invoice`, `get_invoice`, `list_attachable_advance_invoices`, `list_invoices`, `vat_period_summary`, `list_units`, `list_waybill_types`, `list_transport_types`, `lookup_name_by_tin`, `lookup_taxpayer_info`, `list_rs_companies`, `rsge_open_waybills`

### Balance.ge

22 tools. Read-only. Clients, vendors, items, stock, prices, balances, the general ledger and cash flow.

`balance_list_companies`, `balance_check_credentials`, `balance_list_clients`, `balance_list_vendors`, `balance_list_items`, `balance_list_employees`, `balance_list_warehouses`, `balance_list_branches`, `balance_list_price_types`, `balance_get_stocks`, `balance_get_prices`, `balance_find_item`, `balance_list_fixed_assets`, `balance_get_fixed_asset`, `balance_list_documents`, `balance_get_document`, `balance_client_balances`, `balance_vendor_balances`, `balance_fetch_general_ledger`, `balance_cash_flow`, `balance_open_financials`, `balance_open_operations`

### 1C (OneSoft)

21 tools. Read-only. Items, counterparties, contracts, stock, prices, receivables and payables, cash, documents, account turnovers and the trial balance.

`onesoft_list_connections`, `onesoft_check_connection`, `onesoft_list_organisations`, `onesoft_list_items`, `onesoft_list_clients`, `onesoft_list_vendors`, `onesoft_list_contracts`, `onesoft_list_warehouses`, `onesoft_list_branches`, `onesoft_list_price_types`, `onesoft_list_currencies`, `onesoft_get_rates`, `onesoft_get_stocks`, `onesoft_get_prices`, `onesoft_client_balances`, `onesoft_vendor_balances`, `onesoft_cash_balances`, `onesoft_cash_flow`, `onesoft_get_document`, `onesoft_account_turnovers`, `onesoft_trial_balance`

### QuickShipper

4 tools. Read-only. Delivery quotes, orders and tracking links. Nothing is booked, changed or cancelled.

`quickshipper_list_connections`, `quickshipper_get_delivery_quote`, `quickshipper_get_order`, `quickshipper_list_orders`

### Banks

5 tools. Read-only. Balances, transactions and statement summaries of the accounts you select at Bank of Georgia, TBC Bank and ProCredit Bank. No payments or transfers.

`bank_list_connections`, `bank_check_connection`, `bank_get_balances`, `bank_list_transactions`, `bank_statement_summary`

### Public registry and NBG rates

4 tools. Read-only. Company, lien and property lookups in the NAPR registry, and the National Bank of Georgia's official rates. Nothing to connect.

`napr_company_lookup`, `napr_lien_check`, `napr_property_lookup`, `nbg_exchange_rates`

## Sign-in and security

- **OAuth 2.1**: Authorization code flow with PKCE, dynamic client registration (RFC 7591) and client ID metadata documents. One scope: mcp. Discovery: `/.well-known/oauth-protected-resource/mcp/`
- **API keys**: For scripts and clients without OAuth. Sent as a Bearer token, shown once, stored as an Argon2 hash and revocable at any time.
- **Logins stay on waybill.ge**: Passwords and keys for your business systems are entered in the dashboard, never in a client, and stored encrypted.
- **Read-only by default**: Only RS.GE tools change data. Every other system is only read: nothing is posted, booked or paid.

## Limits and plans

One monthly action limit covers every connected system.

- Free: 0 GEL, 300 actions a month
- Starter: 19 GEL a month, 5,000 actions a month
- Pro: 39 GEL a month, 15,000 actions a month
- Enterprise: Contact us, Volume by agreement

The plan catalog as JSON: https://waybill.ge/api/v1/plans

### How actions are counted

- Each tool call is one action. Account tools are never counted and keep working at the limit: `check_credentials`, `whoami`, `get_quota_status`, `get_egress_ip`.
- At the limit, tools return a `QUOTA_EXCEEDED` error with upgrade links.
- The Free allowance resets on the 1st of each month at 00:00 Tbilisi time.
- The public REST API is limited per IP and sends RateLimit headers. Over the limit it answers 429 with Retry-After.

### Versioning

- /api/v1 keeps its response shapes. A breaking change ships as a new path version.
- MCP tool schemas only gain fields. Nothing is removed or repurposed.
- Removals are announced at least 6 months ahead, with Deprecation and Sunset headers (RFC 8594) and on this page.

## Docs and support

- API reference: https://waybill.ge/docs. Swagger UI for the public REST API.
- OpenAPI spec: https://waybill.ge/openapi.json. Typed schemas and operation IDs.
- Public REST API: https://waybill.ge/api/v1/plans. Plan catalog and service health, no sign-in.
- llms.txt: https://waybill.ge/llms.txt. The index for AI agents.
- This page in Markdown: https://waybill.ge/developers.md. Or send Accept: text/markdown.
- Integration questions: hello@waybill.ge