Real US mobile numbers for AI agents: buy numbers, read and send texts with a MeiSIM API key.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer followed by your MeiSIM API key. The account tools need it; the travel eSIM catalog does not.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Order new US phone numbers on your MeiSIM account, paid from its prepaid wallet. Prepaid: no returns, no refunds once a number is delivered. Choose billing "daily" (a minimum number of days paid now, then each day from the wallet) or "monthly" (a minimum number of months paid up front). A monthly order also says line_history: "fresh" or "any"; ask the user which. Call get_number_pricing first and tell the user the total. Numbers usually land within about 15 minutes; check with get_order. Safe to retry with the same customer_reference. Needs your API key.
How many numbers.
"daily" or "monthly". See get_number_pricing.
Daily billing only: days to pay now (at least the minimum).
Also calls over SIP (costs more; must be enabled on the account).
Monthly billing only: months to pay up front (at least the minimum).
5-digit US ZIP to pick the number's area, if available.
Preferred 3-digit US area code, if available.
Monthly billing: "fresh" for a number no other account has held (no refund if the carrier blocks it), or "any" for a number from stock that may have been used before. Required for monthly orders.
Your own reference for this order; a repeat with the same reference returns the first order.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http meisimusa-mcp https://mcp.meisimusa.com/mcp
Headers
Authorization (optional, not in the config above): Bearer followed by your MeiSIM API key. The account tools need it; the travel eSIM catalog does not.Order new US phone numbers on your MeiSIM account, paid from its prepaid wallet. Prepaid: no returns, no refunds once a number is delivered. Choose billing "daily" (a minimum number of days paid now, then each day from the wallet) or "monthly" (a minimum number of months paid up front). A monthly order also says line_history: "fresh" or "any"; ask the user which. Call get_number_pricing first and tell the user the total. Numbers usually land within about 15 minutes; check with get_order. Safe to retry with the same customer_reference. Needs your API key.
| Argument | Type | Description |
|---|---|---|
| days | integer | Daily billing only: days to pay now (at least the minimum). |
| count* | integer | How many numbers. |
| voice | boolean | Also calls over SIP (costs more; must be enabled on the account). |
| months | integer | Monthly billing only: months to pay up front (at least the minimum). |
| billing* | string | "daily" or "monthly". See get_number_pricing. |
| zip_code | string | 5-digit US ZIP to pick the number's area, if available. |
| area_code | string | Preferred 3-digit US area code, if available. |
| line_history | string | Monthly billing: "fresh" for a number no other account has held (no refund if the carrier blocks it), or "any" for a number from stock that may have been used before. Required for monthly orders. |
| customer_reference | string | Your own reference for this order; a repeat with the same reference returns the first order. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"count",
"billing"
],
"properties": {
"days": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Daily billing only: days to pay now (at least the minimum)."
},
"count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many numbers."
},
"voice": {
"type": "boolean",
"description": "Also calls over SIP (costs more; must be enabled on the account)."
},
"months": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Monthly billing only: months to pay up front (at least the minimum)."
},
"billing": {
"enum": [
"daily",
"monthly"
],
"type": "string",
"description": "\"daily\" or \"monthly\". See get_number_pricing."
},
"zip_code": {
"type": "string",
"pattern": "^\\d{5}$",
"description": "5-digit US ZIP to pick the number's area, if available."
},
"area_code": {
"type": "string",
"pattern": "^\\d{3}$",
"description": "Preferred 3-digit US area code, if available."
},
"line_history": {
"enum": [
"fresh",
"any"
],
"type": "string",
"description": "Monthly billing: \"fresh\" for a number no other account has held (no refund if the carrier blocks it), or \"any\" for a number from stock that may have been used before. Required for monthly orders."
},
"customer_reference": {
"type": "string",
"maxLength": 120,
"description": "Your own reference for this order; a repeat with the same reference returns the first order."
}
}
}Show the MeiSIM account behind your API key: company, status, prepaid wallet balance in USD, and how many new numbers you may still activate today. Use before buy_numbers, or when the user asks what is left. Needs your API key.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Get the eSIM install QR code, activation (LPA) string, and status for an order. Pass the order_id from purchase. Status is "ready" when the profile can be installed (after the customer pays).
| Argument | Type | Description |
|---|---|---|
| order_id* | string | The order_id returned by purchase. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"description": "The order_id returned by purchase."
}
}
}MeiSIM's current offer for real US phone lines used by AI agents: the monthly price per number for texts, and for texts plus voice over SIP; the first-term minimum; what a line includes (a real US mobile number on a national carrier, inbound texts to a webhook or over the API, voice over SIP with the number as caller ID, one call at a time, outbound calls to US numbers only); delivery time; payment methods; the lower price per line for more lines and who to write to from 1,000 lines; and links to apply and to the API docs. For people building voice agents, phone assistants, companion apps or SMS customer service who ask what a line costs, what it includes or how to get one. Takes no input. Read-only: it cannot open an account or order a line.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Show what a new US number costs on your MeiSIM account and whether you can order: the daily rate (minimum days, one-time activation fee, how many are ready right now) and the monthly rate (first month, renewals, minimum months), with and without voice. Call before buy_numbers. Needs your API key.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Check a number order from buy_numbers: status (provisioning, partially_fulfilled, fulfilled, delayed, cancelled, closed_refunded), the numbers delivered so far and what was charged. Pass the order_id or your customer_reference. Needs your API key.
| Argument | Type | Description |
|---|---|---|
| order* | string | The order_id or the customer_reference. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"order"
],
"properties": {
"order": {
"type": "string",
"maxLength": 120,
"description": "The order_id or the customer_reference."
}
}
}Confirm the current USD price for a specific eSIM plan before purchasing. Returns the full plan plus a price breakdown and a short-lived quote. Call after search_plans, before purchase.
| Argument | Type | Description |
|---|---|---|
| plan_id* | string | The plan_id (productId) returned by search_plans. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"plan_id"
],
"properties": {
"plan_id": {
"type": "string",
"description": "The plan_id (productId) returned by search_plans."
}
}
}List the US phone numbers on your MeiSIM account: number, status, whether it has voice, how it is billed and the date it is paid through. Paged; pass next_offset to continue. Needs your API key.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Numbers per page, default 100. |
| offset | integer | Where to start; use next_offset from the previous page. |
| search | string | Optional: part of a number or a label to filter by. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Numbers per page, default 100."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Where to start; use next_offset from the previous page."
},
"search": {
"type": "string",
"maxLength": 40,
"description": "Optional: part of a number or a label to filter by."
}
}
}Begin buying an eSIM plan. Returns a secure Stripe payment link the customer opens to pay with their own card; the eSIM + QR are emailed automatically once payment clears. Poll get_activation with the returned order_id to fetch the QR. Safe to retry with the same idempotency_key.
| Argument | Type | Description |
|---|---|---|
| plan_id* | string | The plan_id (productId) to buy, from search_plans / get_quote. |
| customer_email* | string | Where the eSIM/QR is emailed after payment. |
| payment_method | object | Not used: payment happens on the hosted Stripe page via payment_url. Reserved for a future direct-charge path. |
| billing_country | string | |
| idempotency_key | string | Generated if omitted. Reusing a key returns the first checkout instead of starting another. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"plan_id",
"customer_email"
],
"properties": {
"plan_id": {
"type": "string",
"description": "The plan_id (productId) to buy, from search_plans / get_quote."
},
"customer_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Where the eSIM/QR is emailed after payment."
},
"payment_method": {
"type": "object",
"required": [
"type",
"token"
],
"properties": {
"type": {
"enum": [
"stored_card",
"stripe_payment_method"
],
"type": "string"
},
"token": {
"type": "string"
}
},
"description": "Not used: payment happens on the hosted Stripe page via payment_url. Reserved for a future direct-charge path."
},
"billing_country": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"idempotency_key": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Generated if omitted. Reusing a key returns the first checkout instead of starting another."
}
}
}Read the text messages received on your MeiSIM numbers, newest first. Filter to one number and/or to messages after a timestamp. To follow a conversation, pass the received_at of the last message you saw as since. Needs your API key.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Default 50. |
| since | string | ISO 8601 timestamp; only messages received after it. |
| number | string | One of your numbers, e.g. "4234322309" or "+1 423 432 2309". Omit for all numbers. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Default 50."
},
"since": {
"type": "string",
"maxLength": 40,
"description": "ISO 8601 timestamp; only messages received after it."
},
"number": {
"type": "string",
"maxLength": 20,
"description": "One of your numbers, e.g. \"4234322309\" or \"+1 423 432 2309\". Omit for all numbers."
}
}
}Search travel eSIM data plans for a destination country. Returns plans with data allowance, validity in days, and USD price. Use this first when a user wants mobile data for a trip (e.g. "5GB in Italy for 10 days"). Returns a plan_id to pass to get_quote / purchase.
| Argument | Type | Description |
|---|---|---|
| data_gb | number | Minimum data in GB. Omit to return all sizes (unlimited plans always pass). |
| sort_by | string | Result ordering. "price" = cheapest first (default). |
| country_code* | string | Destination country as an ISO 3166-1 alpha-2 code, e.g. "IT" for Italy. |
| duration_days* | integer | Days of coverage needed. Plans shorter than this are filtered out. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"country_code",
"duration_days"
],
"properties": {
"data_gb": {
"type": "number",
"description": "Minimum data in GB. Omit to return all sizes (unlimited plans always pass).",
"exclusiveMinimum": 0
},
"sort_by": {
"enum": [
"price",
"data_per_dollar",
"duration"
],
"type": "string",
"default": "price",
"description": "Result ordering. \"price\" = cheapest first (default)."
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"maxLength": 2,
"minLength": 2,
"description": "Destination country as an ISO 3166-1 alpha-2 code, e.g. \"IT\" for Italy."
},
"duration_days": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Days of coverage needed. Plans shorter than this are filtered out.",
"exclusiveMinimum": 0
}
}
}Find real US phone-number plans (a genuine US carrier line with calls, texts, and data, no SSN or contract). Use this when the user wants an actual US number, not just travel data. Returns a plan_id for purchase.
| Argument | Type | Description |
|---|---|---|
| max_price_usd | number | Optional max monthly price in USD. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"max_price_usd": {
"type": "number",
"description": "Optional max monthly price in USD.",
"exclusiveMinimum": 0
}
}
}Send a text message from one of your MeiSIM numbers to a US number. Sending must be enabled on your account and each number has a monthly allowance; a refusal tells you which. The answer means accepted by the carrier: a mobile line has no delivery receipt. The same text to more than three numbers from one line inside an hour is refused (carriers drop that as a broadcast); write to each person in their own words. Not for emergency services. Needs your API key.
| Argument | Type | Description |
|---|---|---|
| to* | string | The destination number, e.g. "+1 212 555 0100". |
| from* | string | One of your numbers. |
| message* | string | The text to send, up to 800 characters. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"from",
"to",
"message"
],
"properties": {
"to": {
"type": "string",
"maxLength": 20,
"description": "The destination number, e.g. \"+1 212 555 0100\"."
},
"from": {
"type": "string",
"maxLength": 20,
"description": "One of your numbers."
},
"message": {
"type": "string",
"maxLength": 800,
"minLength": 1,
"description": "The text to send, up to 800 characters."
}
}
}Look up an existing US prepaid line (by phone) or an eSIM (by ICCID / order) and list the top-up plans available for it. Returns product_ids to pass to topup_start.
| Argument | Type | Description |
|---|---|---|
| string | Customer email (required for esim lookup). | |
| iccid | string | eSIM ICCID (for esim). |
| phone | string | US phone number (for us_prepaid). |
| carrier | string | Carrier name/id (for us_prepaid; see topup carriers). |
| line_type* | string | "us_prepaid" for a US phone line, "esim" for a travel eSIM. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"line_type"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Customer email (required for esim lookup)."
},
"iccid": {
"type": "string",
"description": "eSIM ICCID (for esim)."
},
"phone": {
"type": "string",
"description": "US phone number (for us_prepaid)."
},
"carrier": {
"type": "string",
"description": "Carrier name/id (for us_prepaid; see topup carriers)."
},
"line_type": {
"enum": [
"us_prepaid",
"esim"
],
"type": "string",
"description": "\"us_prepaid\" for a US phone line, \"esim\" for a travel eSIM."
}
}
}Start a top-up/recharge for an existing line or eSIM, using a product_id from topup_lookup. Returns an order_id and a payment URL where the customer completes payment. For range plans, pass custom_amount.
| Argument | Type | Description |
|---|---|---|
| iccid | string | eSIM ICCID (esim). |
| phone | string | US phone (us_prepaid). |
| carrier | string | |
| line_type* | string | |
| product_id* | string | Top-up plan id from topup_lookup. |
| custom_amount | number | For range/RTR plans only. |
| customer_email* | string | |
| source_order_id | string | Original eSIM order id (esim). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"line_type",
"product_id",
"customer_email"
],
"properties": {
"iccid": {
"type": "string",
"description": "eSIM ICCID (esim)."
},
"phone": {
"type": "string",
"description": "US phone (us_prepaid)."
},
"carrier": {
"type": "string"
},
"line_type": {
"enum": [
"us_prepaid",
"esim"
],
"type": "string"
},
"product_id": {
"type": "string",
"description": "Top-up plan id from topup_lookup."
},
"custom_amount": {
"type": "number",
"description": "For range/RTR plans only.",
"exclusiveMinimum": 0
},
"customer_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"source_order_id": {
"type": "string",
"description": "Original eSIM order id (esim)."
}
}
}Wait for the next text message on one of your MeiSIM numbers and return it. Blocks up to timeout_seconds (default 30, max 50). Pass since as the time you started waiting (default: now) so an older message is not mistaken for the new one. If nothing arrives, received is false; call again to keep waiting. Needs your API key.
| Argument | Type | Description |
|---|---|---|
| since | string | ISO 8601; only a message received after this counts. Default: now. |
| number | string | One of your numbers. Omit to watch every number on the account. |
| timeout_seconds | integer | How long to wait, default 30. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"since": {
"type": "string",
"maxLength": 40,
"description": "ISO 8601; only a message received after this counts. Default: now."
},
"number": {
"type": "string",
"maxLength": 20,
"description": "One of your numbers. Omit to watch every number on the account."
},
"timeout_seconds": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How long to wait, default 30."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.