English Français العربية

io.github.flovoice53-tech/agent-identity-mcp

Official registry Productivity

Gives an AI agent a disposable email and a real UK phone number to test signup flows.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package agent-identity-mcp
Claude Code 
claude mcp add agent-identity-mcp -e 'SMS_FLORIN_API_KEY=<your sms_florin_api_key>' -- npx -y agent-identity-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agent-identity-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "agent-identity-mcp@0.1.1"
            ],
            "env": {
                "SMS_FLORIN_API_KEY": "<your sms_florin_api_key>"
            }
        }
    }
}

Environment variables

  • SMS_FLORIN_API_KEY required secret API key from https://flo-voice1.com/api-access, used for the phone-number tools

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. agent-identity-mcp
  2. Status: published on npm and the official MCP registry
  3. Setup
  4. Tools
  5. Pairs well with: acp-sandbox
  6. Pairs well with: otp-watch
  7. License

agent-identity-mcp

MCP server that gives an AI agent a throwaway test identity — a real disposable email address and a real UK phone number — so it can sign up for something it's testing and read back the verification email/SMS itself, without a human in the loop.

Bundles two existing services:

Status: published on npm and the official MCP registry

create_test_email no longer needs any receivemail.dev credential — mailbox creation is public/self-serve (rate-limited: 20/min per IP, 5,000/day total). The only credential needed is your own SMS_FLORIN_API_KEY, for the phone-number tools.

Setup

{
  "mcpServers": {
    "agent-identity": {
      "command": "npx",
      "args": ["-y", "agent-identity-mcp"],
      "env": {
        "SMS_FLORIN_API_KEY": "your_key_here"
      }
    }
  }
}

Tools

ToolDescription
create_test_emailGet a fresh disposable email address, valid up to 60 minutes.
get_test_email_messagesRead what's arrived on an address created above.
list_servicesList services a phone number can be rented for.
rent_test_phone_numberRent a real UK number for a service. Costs balance.
wait_for_test_smsBlock until the SMS/OTP code arrives.
list_esim_plansList travel eSIM data plans (data only, no SMS).
get_esim_checkout_linkGet a Stripe checkout link for an eSIM plan, for the user to pay.
get_usage_statsSee how many times each tool was called — today, last 7 and last 30 days. On the hosted server it's per API key and survives restarts; locally it counts since the MCP client started the server. Failed calls aren't counted.

Pairs well with: acp-sandbox

Building or testing an AI shopping agent (ACP/agentic commerce)? acp-sandbox is a hosted mock merchant your agent can complete a full test checkout against — no real store, no real money. Combined with this package, an agent gets a disposable email/phone for the buyer identity and a merchant to actually check out with, entirely test-side.

Pairs well with: otp-watch

Ship your own signup/verification flow? otp-watch uses the same underlying real phone numbers and disposable mailboxes to answer a different question: is your OTP/verification SMS or email actually arriving, and how fast? Point your own cron/CI at it to catch a broken delivery pipeline before your users do.

License

MIT

Frequently asked questions

What is io.github.flovoice53-tech/agent-identity-mcp?

Gives an AI agent a disposable email and a real UK phone number to test signup flows.

How do I install io.github.flovoice53-tech/agent-identity-mcp?

It runs on your machine. In Claude Code: claude mcp add agent-identity-mcp -e 'SMS_FLORIN_API_KEY=<your sms_florin_api_key>' -- npx -y agent-identity-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.flovoice53-tech/agent-identity-mcp need an API key?

Yes. It expects SMS_FLORIN_API_KEY, which you set in its configuration.

Is io.github.flovoice53-tech/agent-identity-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.flovoice53-tech/agent-identity-mcp?

It is published by flovoice53-tech. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.