AMI es la capa de protocolo para que un agente solicite, contrate y active su propia identidad móvil — SIM, eSIM, número de teléfono — sin pasar por procesos pensados para humanos. Programable, auditable, gobernada. AMI is the protocol layer for AI agents to request, contract and activate their own mobile identity — SIM, eSIM, phone numbers — without going through human-designed processes. Programmable, auditable, governed.
Las cuatro vías llegan al mismo MCP server con las 11 tools ami.*. HTTP remoto es la opción recomendada para agentes: cero instalación y sin gestionar API key local. Las otras vías son útiles cuando necesitas el MCP corriendo en local (clientes que solo soportan stdio, entornos sin red saliente, etc.).
All four paths reach the same MCP server with the 11 ami.* tools. Remote HTTP is the recommended option for agents: zero install, no local API key to manage. The other paths are useful when you need the MCP running locally (stdio-only clients, no-egress environments, etc.).
AMI separa el "cómo se contrata identidad móvil" del "qué operador la sirve". El agente habla un solo protocolo; el operador se enchufa por debajo. AMI separates "how mobile identity is contracted" from "which operator serves it". The agent speaks one protocol; the carrier plugs in underneath.
Solicitud, oferta, datos del cliente, contrato y firma como llamadas de tool. Sin formularios. Sin humanos atascando el flujo.
Request, offer, customer data, contract and signature as tool calls. No forms. No humans bottlenecking the flow.
Cada número tiene propietario, contrato firmado, política y trazabilidad. Sin shadow IT. Sin números fantasma operando en nombre de empresas.
Every number has an owner, signed contract, policy and audit trail. No shadow IT. No phantom numbers operating on behalf of companies.
El agente consume AMI; debajo se elige operador, BSP o gateway. Cambias de proveedor sin tocar la integración del agente.
The agent consumes AMI; underneath you pick carrier, BSP or gateway. Swap providers without touching the agent integration.
Cada transición de estado emite un AuditEvent. Quién, qué, cuándo, con qué payload. Compliance no es una capa extra — es el modelo.
Every state transition emits an AuditEvent. Who, what, when, with what payload. Compliance isn't an extra layer — it's the model.
El agente recorre la máquina de estados completa por MCP. La firma sucede en el navegador del firmante (o vía webhook de proveedor de firma); el resto es máquina. The agent walks the full state machine via MCP. The signature happens in the signer's browser (or via signature provider webhook); everything else is machine-to-machine.
Agent ─┐ MCP tools (ami.*) ▼ ami_mcp.py stdio + streamable-http │ HTTPS + Bearer ▼ ami_api.py REST v1 · state machine · audit log │ ├──▶ SIMRequest requested ├──▶ Offer offer_created → offer_accepted ├──▶ Customer customer_data_submitted ├──▶ Contract signature_pending │ ↑ signed via /v1/sign/{id} (browser) ├──▶ Signed signed ├──▶ Provisioning carrier adapter └──▶ MobileIdentity active · number · QR
El backend está en producción. Lo único simulado es la SIM física: el resto —oferta, contrato, firma y activación— es real y end-to-end. The backend is in production. Only the physical SIM is simulated: the rest —offer, contract, signature, activation— is real and end-to-end.
Clona el repo, instala el venv y añade el bloque a tu claude_desktop_config.json. Las 11 tools ami.* aparecen al reiniciar.
Clone the repo, install the venv and add the block to your claude_desktop_config.json. The 11 ami.* tools appear after restart.
{
"mcpServers": {
"ami": {
"command": "python3",
"args": [
"/path/to/AMI/ami_mcp.py"
],
"env": {
"AMI_API_URL": "https://ami-mock-api.onrender.com",
"AMI_API_KEY": "<your-api-key>"
}
}
}
}
Cualquier cliente MCP que soporte el transporte streamable-http conecta directo. Cero instalación, cero deps locales.
Any MCP client that supports streamable-http connects directly. Zero install, zero local deps.
https://ami-mcp-http.onrender.com/mcp/
¿No usas MCP? Habla directo a la REST API. Esquema OpenAPI 3.1 publicado en /openapi.json. Auth con Bearer.
Not using MCP? Talk directly to the REST API. OpenAPI 3.1 schema at /openapi.json. Bearer auth.
curl -H "Authorization: Bearer $AMI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country":"ES"}' \
https://<host>/v1/sim-requests
Todas en ami.*. Cada una mapea a un endpoint REST equivalente; el agente puede usar la que prefiera sin perder semántica.
All under ami.*. Each maps to an equivalent REST endpoint; the agent can use whichever it prefers without losing semantics.
Auth con Authorization: Bearer $AMI_API_KEY excepto en healthcheck y la página pública de firma.
Auth with Authorization: Bearer $AMI_API_KEY except for healthcheck and the public signature page.
/v1/healthHealthcheck (público)./v1/sim-optionsPaíses y SIMs disponibles./v1/sim-requestsCrea SIMRequest y oferta./v1/sim-requests/{id}/cancelCancela una SIMRequest./v1/sim-requests/{id}/customer-dataVincula datos del cliente./v1/offers/{id}/acceptAcepta una oferta./v1/contractsCrea contrato y signature_url./v1/contracts/{id}Consulta el contrato./v1/sign/{id}Página HTML de firma (pública)./v1/sign/{id}/confirmCallback del form de firma (público)./v1/mobile-identities/activateActiva la MobileIdentity tras la firma./v1/mobile-identities/{id}Consulta una MobileIdentity./v1/eventsÚltimos AuditEvents./v1/demo/quickFlujo end-to-end completo en una llamada (público, sin auth)./identity/{id}Página pública de una MobileIdentity activa./specSpec del protocolo renderizada en HTML.