Identidad móvil
para agentes AI. Mobile identity
for AI agents.

Cuatro principios. Una capa estándar. Four principles. One standard layer.

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.

De solicitud a número activo, sin humano en medio. From request to active number, no human in the loop.

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

Tres formas de conectar tu agente. Three ways to connect your agent.

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.

{
  "mcpServers": {
    "ami": {
      "command": "python3",
      "args": [
        "/path/to/AMI/ami_mcp.py"
      ],
      "env": {
        "AMI_API_URL": "https://protocolami.com",
        "AMI_API_KEY": "<your-api-key>"
      }
    }
  }
}

https://mcp.protocolami.com/mcp/

curl -H "Authorization: Bearer $AMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"ES"}' \
  https://<host>/v1/sim-requests

28 tools. Un namespace. 28 tools. One namespace.

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.

API estable, JSON, OpenAPI 3.1. Stable JSON API, OpenAPI 3.1.

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.

• GET/v1/healthHealthcheck (público).
• GET/v1/sim-optionsPaíses y SIMs disponibles.
• POST/v1/sim-requestsCrea SIMRequest y oferta.
• POST/v1/sim-requests/{id}/cancelCancela una SIMRequest.
• POST/v1/sim-requests/{id}/customer-dataVincula datos del cliente.
• POST/v1/offers/{id}/acceptAcepta una oferta.
• POST/v1/sim-requests/{id}/kyc/initiateDispara el KYC del rep. legal (devuelve verification_url).
• GET/v1/sim-requests/{id}/kycEstado del KYC de la solicitud.
• POST/v1/contractsCrea contrato y signature_url.
• GET/v1/contracts/{id}Consulta el contrato.
• GET/v1/sign/{id}Página HTML de firma (pública).
• POST/v1/sign/{id}/confirmCallback del form de firma (público).
• POST/v1/mobile-identities/activateActiva la MobileIdentity tras la firma (acepta voice_url opcional: webhook de voz del agente).
• GET/v1/mobile-identities/{id}Consulta una MobileIdentity.
• POST/v1/mobile-identities/{id}/rotate-tokenRota el agent_token (hard rotate).
• POST/v1/mobile-identities/{id}/inbound-configSetea el endpoint SIP para llamadas entrantes.
• GET/v1/mobile-identities/{id}/limitsLee los límites del MID.
• POST/v1/mobile-identities/{id}/limitsActualiza los límites del MID.
• GET/v1/mobile-identities/{id}/usageUsage actual del MID (auth: customer).
• POST/v1/mobile-identities/{id}/webhooksCrea un webhook saliente para un MID.
• GET/v1/mobile-identities/{id}/webhooksLista los webhooks del MID.
• POST/v1/mobile-identities/{id}/webhooks/{wh}/deleteBorra un webhook.
• GET/v1/agent/selfInfo de la MobileIdentity dueña del agent_token.
• POST/v1/agent/sms/sendEnvía un SMS desde el MID (auth: agent_token).
• GET/v1/agent/smsLista los SMS del MID (filtrable por dirección).
• POST/v1/agent/calls/placeOrigina una llamada saliente bridgeada por SIP.
• GET/v1/agent/callsLista las llamadas del MID.
• GET/v1/agent/calls/{id}Detalle de una llamada del MID.
• POST/v1/agent/calls/{id}/hangupTermina una llamada del MID.
• GET/v1/agent/usageUsage del MID dueño del agent_token.
• POST/v1/admin/customersCrear customer-account (devuelve API key una vez).
• GET/v1/admin/customersListar customer-accounts (sin secret).
• POST/v1/admin/customers/{id}/rotate-keyRotar la API key de un customer.
• POST/v1/admin/customers/{id}/suspendSuspender un customer.
• POST/v1/admin/customers/{id}/activateReactivar un customer suspended.
• GET/v1/eventsÚltimos AuditEvents.
• POST/v1/demo/quickFlujo end-to-end completo en una llamada (público, sin auth).
• GET/identity/{id}Página pública de una MobileIdentity activa.
• GET/specSpec del protocolo renderizada en HTML.
• GET/diagramAnimación standalone del ciclo de vida del stack.
• GET/docsPortal de documentación interactivo (bilingüe).