Management MCP
An agent starts the account; the person confirms it, connects WhatsApp and chooses a plan.
- Endpoint
https://api.app2email.com/mcp/manageStreamable HTTP · protocol 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05- Auth
none for create_sandbox, create_account, list_plans and estimate_cost; Authorization: Bearer <management_key> for the rest- REST
https://api.app2email.com/v1/account/…· same tools, same auth
Flow
create_account {"contact_email": "owner@example.com"}→signup_id,management_key(shown once),onboarding_link,message. No key needed.- The person opens
onboarding_link: confirms the e-mail, connects their WhatsApp number, chooses a plan. Nothing can be sent before that. get_account_status→pending_email·pending_whatsapp·pending_payment·live. SendAuthorization: Bearer <management_key>from here on.create_number_key {"number": "4976659348270", "scopes": ["messages:send", "messages:read"], "sandbox": true}→ a key for the messaging MCP (https://api.app2email.com/mcp) and the REST API.
Install
create_account and list_plans work without the header; add it once you have the key.
claude mcp add --transport http app2email-manage https://api.app2email.com/mcp/manage --header "Authorization: Bearer YOUR_MANAGEMENT_KEY" {
"mcpServers": {
"app2email-manage": {
"type": "http",
"url": "https://api.app2email.com/mcp/manage",
"headers": {
"Authorization": "Bearer ${APP2EMAIL_MANAGEMENT_KEY}"
}
}
}
} Customize → Connectors → + Add → Add custom connector. Docs
URL: https://api.app2email.com/mcp/manage
Authentication: No sign in
Request header: Authorization: Bearer YOUR_MANAGEMENT_KEY ~/.cursor/mcp.json Docs
{
"mcpServers": {
"app2email-manage": {
"url": "https://api.app2email.com/mcp/manage",
"headers": {
"Authorization": "Bearer ${env:APP2EMAIL_MANAGEMENT_KEY}"
}
}
}
} .vscode/mcp.json Docs
{
"inputs": [
{
"type": "promptString",
"id": "app2email-manage-key",
"description": "app2email management key",
"password": true
}
],
"servers": {
"app2email-manage": {
"type": "http",
"url": "https://api.app2email.com/mcp/manage",
"headers": {
"Authorization": "Bearer ${input:app2email-manage-key}"
}
}
}
} ~/.codex/config.toml, with APP2EMAIL_MANAGEMENT_KEY set in the environment. Docs
[mcp_servers.app2email-manage]
url = "https://api.app2email.com/mcp/manage"
bearer_token_env_var = "APP2EMAIL_MANAGEMENT_KEY" Needs OAuth: not yet.
Tools
| Tool | What | Kind |
|---|---|---|
| create_sandbox | Try the API now, with no account and no person: an instant sandbox key (shown once, valid 7 days) for app2email's demo number, its pretend customers and the fi… | changes |
| create_account | Start an app2email account for a person. | changes |
| get_account_status | What the account still needs: pending_email, pending_whatsapp, pending_payment or live, with its numbers and next steps. | read-only |
| list_plans | The plans that can be bought, with prices (US$) and whether they include the API. | read-only |
| estimate_cost | What app2email costs for a number of messages a month: the plan that fits and its exact price (US$). | read-only |
| list_numbers | The account's WhatsApp numbers with their status and plan. | read-only |
| get_payment_link | A Stripe Checkout link for a plan of one number. | changes |
| create_number_key | A key for one live number, for the messaging MCP server and the REST API. | changes |
| list_number_keys | The keys of one number (never the keys themselves). | read-only |
| revoke_number_key | Revoke one key of a number. | destructive |
| get_usage | Messages sent this billing month and the plan limit, for every number or one. | read-only |
REST twins
- POST /v1/account/sandbox Instant sandbox: try the API with no account
create_sandbox - POST /v1/account/signup Start an account for a person (agent sign-up)
create_account - GET /v1/account Account status and what is still needed
get_account_status - GET /v1/account/plans Plans that can be bought
list_plans - GET /v1/account/estimate Cost estimate for a number of messages a month
estimate_cost - GET /v1/account/numbers The account's WhatsApp numbers
list_numbers - GET /v1/account/numbers/{number} One number of the account
- GET /v1/account/numbers/{number}/keys The keys of a number
list_number_keys - POST /v1/account/numbers/{number}/keys Create a key for a number
create_number_key - DELETE /v1/account/numbers/{number}/keys/{key_id} Revoke a key of a number
revoke_number_key - POST /v1/account/numbers/{number}/checkout Payment link for a plan of a number
get_payment_link - GET /v1/account/usage Messages used this billing month, per number
get_usage - GET /v1/account/keys Account keys
- POST /v1/account/keys Create an account key
- DELETE /v1/account/keys/{key_id} Revoke an account key
- GET /v1/account/webhooks Account webhooks
- POST /v1/account/webhooks Add an account webhook
- PATCH /v1/account/webhooks/{id} Change an account webhook
- DELETE /v1/account/webhooks/{id} Delete an account webhook
- POST /v1/account/webhooks/{id}/test Send a test event to an account webhook
- POST /v1/account/webhooks/{id}/rotate-secret New signing secret for an account webhook
- GET /v1/account/webhooks/{id}/deliveries Deliveries of an account webhook
- GET /v1/account/webhooks/{id}/deliveries/{event_id} One delivery of an account webhook
- POST /v1/account/webhooks/{id}/deliveries/{event_id}/redeliver Send a stored event again to an account webhook