Hosted MCP
Hosted MCP for SMS OTP + transactional SMS agents
Point Cursor, Claude, ChatGPT-style agents, or your own bot at Robase over Streamable HTTP. Phase 1 tools map to the same REST OTP and SMS paths, prepaid credits, and error.type values.
Hosted MCP is a Model Context Protocol server so an editor or chatbot can discover tools and send SMS OTP without a custom integration layer. The endpoint is https://api.robase.dev/mcp.
It is the same workspace and the same credits as curl.
Create an Agent key (robe_agent_) under Dashboard → API keys at robase.dev/app. Workspace keys (robe_) still work. Revoke the key to stop the next tool call — there is no auth cache.
Connect
In Cursor: Settings → MCP → add the URL and the Bearer header. MCP Inspector uses the same pair. We do not claim a Cursor App Store listing.
URL
https://api.robase.dev/mcp
Transport
Streamable HTTP
Auth
Authorization: Bearer robe_… or robe_agent_…
https://api.robase.dev/mcp Authorization: Bearer robe_agent_xxx
Hosts that support tool approval should require approval on send_otp and send_sms until you turn that off. Idempotency-Key is set automatically on POST tools if the caller omits it.
Phase 1 tools
Six tools. Each maps to the same REST path as the AI agents guide. No payment, top-up, team, KYB upload, webhook CRUD, or admin tools.
| Tool | REST | Side effect |
|---|---|---|
| get_pricing | GET /v1/pricing | None. Call this for destinations; treat listed:true as marketed markets. |
| send_otp | POST /v1/otp/send | Spends credits. |
| verify_otp | POST /v1/otp/verify | Consumes an attempt. |
| get_otp | GET /v1/otp/{id} | None. The code is never returned. |
| send_sms | POST /v1/sms/send | Spends credits; antispam may block and refund. |
| get_sms | GET /v1/sms/{id} | None. |
Coverage & pricing
One prepaid credit = ₦6. Signup trial is 10 credits (₦60). A United States destination is 100 credits (₦600) — not the trial. Credits never expire and cover both OTP and transactional SMS, REST or MCP.
| Country | Code | Credits | Example price | Routing |
|---|---|---|---|---|
| Nigeria | NG | 1 | ₦6 | Multi-provider failover |
| Ghana | GH | 3 | ₦18 | Multi-provider failover |
| Kenya | KE | 3 | ₦18 | Multi-provider failover |
| South Africa | ZA | 4 | ₦24 | Multi-provider failover |
| United Kingdom | GB | 8 | ₦48 | Single-provider today |
| Benin | BJ | 56 | ₦336 | Multi-provider failover |
| Ivory Coast | CI | 79 | ₦474 | Multi-provider failover |
| United States | US | 100 | ₦600 | Single-provider today |
Call get_pricing and treat listed:true as marketed. We do not publish a delivery-rate percentage. See the pricing breakdown.
Claim-safe agent rules
- Prefer OTP-shaped tests: Your Robase test OTP is 123456. Do not send greetings such as Hello or Good morning — those may be blocked and refunded.
- Match failures on error.type. Handle insufficient_credits, account_temporarily_restricted, kyc_required, and sms.blocked.
- On insufficient_credits, ask a human to top up in the dashboard. The agent has no payment tool.
- Never paste API keys into chat. Official REST SDKs remain Node, Go, and PHP only.
Hosted MCP FAQ
What is Robase hosted MCP?
A Streamable HTTP Model Context Protocol server at https://api.robase.dev/mcp. Cursor, Claude, ChatGPT-style agents, or your own bot can call the same prepaid SMS OTP and transactional SMS operations as REST, with the same credits and error.type values.
How do I connect an agent?
Create an Agent key (prefix robe_agent_) under Dashboard → API keys at https://robase.dev/app. Point the host at https://api.robase.dev/mcp and send Authorization: Bearer robe_agent_…. Workspace robe_ keys also work. In Cursor: Settings → MCP → add the URL and the Bearer header.
Which tools ship in Phase 1?
get_pricing, send_otp, verify_otp, get_otp, send_sms, and get_sms. They map to the same REST paths as the AI agents guide. There are no payment, top-up, team, KYB upload, webhook CRUD, or admin tools.
How is MCP billed?
The same prepaid credits as REST. 1 credit = ₦6. Signup trial is 10 credits (₦60). A United States destination is 100 credits (₦600), not the trial amount. Verification calls are free.
Which countries are priced?
Published priced markets are Nigeria, Ghana, Kenya, South Africa, the United Kingdom, Benin, Ivory Coast, and the United States. Nigeria, Ghana, Kenya, South Africa, Benin, and Ivory Coast have multi-provider failover; the UK and US are currently single-provider. Call get_pricing and treat listed:true as marketed. Do not invent extra countries or delivery percentages.
Why was my test Hello message blocked?
Greeting bodies such as Hello or Good morning may be classified as marketing, blocked, and refunded. Prefer an OTP-shaped test: Your Robase test OTP is 123456.
Can the agent top up credits?
No. Phase 1 has no payment or top-up tool. On insufficient_credits, a human tops up under Billing in the dashboard. Daily credit cap for agent keys is unlimited by default, same as REST.
Is hosted MCP in the Cursor App Store?
No storefront listing is claimed. Add the URL and Bearer header in the host’s MCP settings. Setup steps are in the AI agents guide at docs.robase.dev/guides/ai-agents.
Keep reading
- Setup, tool list, and sample prompt: AI agents guide.
- How we explain the ship: Hosted MCP for SMS OTP and transactional SMS agents.
- REST surfaces: OTP API · SMS API.
Then create an Agent key and follow the AI agents guide.
Last updated: September 20, 2026