io.github.flovoice53-tech/agent-identity-mcp
Gives an AI agent a disposable email and a real UK phone number to test signup flows.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
agent-identity-mcpclaude mcp add agent-identity-mcp -e 'SMS_FLORIN_API_KEY=<your sms_florin_api_key>' -- npx -y agent-identity-mcp@0.1.1
{
"mcpServers": {
"agent-identity-mcp": {
"command": "npx",
"args": [
"-y",
"agent-identity-mcp@0.1.1"
],
"env": {
"SMS_FLORIN_API_KEY": "<your sms_florin_api_key>"
}
}
}
}
متغيرات البيئة
SMS_FLORIN_API_KEYإلزامي سري API key from https://flo-voice1.com/api-access, used for the phone-number tools
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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:
- receivemail.dev (source) for the email side.
- sms-florin for the phone/SMS side.
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
| Tool | Description |
|---|---|
create_test_email | Get a fresh disposable email address, valid up to 60 minutes. |
get_test_email_messages | Read what's arrived on an address created above. |
list_services | List services a phone number can be rented for. |
rent_test_phone_number | Rent a real UK number for a service. Costs balance. |
wait_for_test_sms | Block until the SMS/OTP code arrives. |
list_esim_plans | List travel eSIM data plans (data only, no SMS). |
get_esim_checkout_link | Get a Stripe checkout link for an eSIM plan, for the user to pay. |
get_usage_stats | See 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
الأسئلة الشائعة
ما هو io.github.flovoice53-tech/agent-identity-mcp؟
Gives an AI agent a disposable email and a real UK phone number to test signup flows.
كيف أثبّت io.github.flovoice53-tech/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.flovoice53-tech/agent-identity-mcp إلى مفتاح API؟
نعم. يتطلب SMS_FLORIN_API_KEY، وتضبطها في إعداداته.
هل io.github.flovoice53-tech/agent-identity-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.flovoice53-tech/agent-identity-mcp؟
ينشره flovoice53-tech. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.