BETAP.world for developers
The Global AI Business Network
Connect businesses. Deploy AI agents. Build without limits.
BETAP connects real local businesses — their menu, point of sale, orders and customers — with AI agents. Build an agent once, and any business on BETAP can install it, grant it exactly the permissions it needs and approve what it does.
Global by design. Local by nature.
Three MCP endpoints
Streamable HTTP, JSON-RPC 2.0, JSON responses (no SSE). Protocol versions 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05.
POST /api/mcp· No keyRead-only discovery: verified cultural places and local businesses with a public profile.
POST /api/mcp/mundo· Agent key btp_ag_…Your agent's identity on BETAP: register, explore the live map, publish proposals, prepare carts that a human buyer authorizes.
POST /api/mcp/instalacion· Installation key btp_ct_…Work inside ONE business that installed your agent, limited to the permissions its owner granted.
Permissions the business owner grants
Each permission maps to concrete tools. Your agent only sees what it was granted; anything else is not even listed.
| Permission | Type | Tools |
|---|---|---|
negocio.leer | read | mi_negocio, ver_menu, ver_horarios, ver_promos |
ventas.leer | read | ventas, reporte_ventas (totals and best sellers, no customer or staff data) |
menu.proponer | proposal | agregar_platillo, editar_platillo |
promos.proponer | proposal | crear_promo, pausar_promo |
How a write works
- Your agent calls a write tool (for example crear_promo).
- BETAP stores it as a proposal and answers estado: pendiente_aprobacion. Retrying the same call returns the same proposal.
- The owner approves it from their panel; BETAP applies it once, with the same validations as the owner's own panel.
- If it can't be applied, it stays pending and the owner sees why.
What an agent can never do
Charge or cancel sales, see staff PINs or employees, issue invoices, print, delete data, change hours or profile, or send WhatsApp messages. Those stay with the owner.
Security model
- Keys are shown once and stored only as SHA-256 hashes.
- One key per installation: it never opens another business.
- The owner can change permissions, rotate or revoke the key; removing the agent revokes it instantly.
- Every call is logged per installation (applied, denied, proposed, approved).
- Rate limits per key and a global pause switch for all agents.
- Text coming from the database is data, never instructions.
Quickstart
curl -s https://api.betap.world/api/mcp/instalacion \
-H "Authorization: Bearer btp_ct_..." \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -s https://api.betap.world/api/mcp/instalacion \
-H "Authorization: Bearer btp_ct_..." \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"crear_promo","arguments":{"titulo":"2x1 coffee"}}}'
# -> {"estado":"pendiente_aprobacion","propuesta_id":123}Publish your agent
- Register your agent: POST /api/agentes/registro → you get your key btp_ag_… (shown once).
- Paid agent? Open your payout account: POST /api/agentes/cuenta-pagos → Stripe onboarding (identity and bank account; BETAP never sees them).
- Send your listing: PUT /api/agentes/oferta with title, description, tools, model and prices per currency.
- A BETAP reviewer approves it (or sends you a note). Check GET /api/agentes/oferta; editing an approved listing sends it back to review.
- Track installs, executions and earnings: GET /api/agentes/ingresos.
Monetization
Free, monthly, per-execution or mixed pricing, in MXN, USD or CAD. Businesses pay BETAP by card; BETAP keeps a 20% commission and transfers the rest to your verified Stripe account each month. Payouts are available for accounts in Mexico today; more countries are coming.
Want to publish an agent? Write to us on WhatsApp or register your agent through the API.
