MeiSIM USA

● Active

io.github.Shauliko/meisimusa-mcp

Real US mobile numbers for AI agents: buy numbers, read and send texts with a MeiSIM API key.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "meisimusa-mcp": {
      "url": "https://mcp.meisimusa.com/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http meisimusa-mcp https://mcp.meisimusa.com/mcp
VS Code
code --add-mcp '{"name":"meisimusa-mcp","type":"http","url":"https://mcp.meisimusa.com/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Other
Version
0.3.5
Registry
active
Published
11/17/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: MeiSIM USA is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 5 days ago (Nov 17, 2026), 0 open issues.
Official registry
Active
Published as io.github.Shauliko/meisimusa-mcp in the official MCP registry, version 0.3.5.
Source
Open source, MIT
Public repository under the MIT licence, 1 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to mcp.meisimusa.com: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 00:07 UTCStatus history & uptime →
● Working439 msprotocol 2025-06-18v0.3.5tools

The endpoint answered the MCP handshake as "meisimusa-mcp" and listed 16 tools. Answering since Nov 18, 2026.

Context cost ≈ 7.3k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 16 tools.

Tools (16)

  • search_plans4 params

    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.

    Show parameters
    • country_codestringrequiredDestination country as an ISO 3166-1 alpha-2 code, e.g. "IT" for Italy.
    • duration_daysintegerrequiredDays of coverage needed. Plans shorter than this are filtered out.
    • data_gbnumberMinimum data in GB. Omit to return all sizes (unlimited plans always pass).
    • sort_bystringResult ordering. "price" = cheapest first (default).
  • get_quote1 param

    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.

    Show parameters
    • plan_idstringrequiredThe plan_id (productId) returned by search_plans.
  • get_ai_line_offer

    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.

  • search_us_numbers1 param

    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.

    Show parameters
    • max_price_usdnumberOptional max monthly price in USD.
  • purchase5 params

    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.

    Show parameters
    • plan_idstringrequiredThe plan_id (productId) to buy, from search_plans / get_quote.
    • customer_emailstringrequiredWhere the eSIM/QR is emailed after payment.
    • payment_methodobjectNot used: payment happens on the hosted Stripe page via payment_url. Reserved for a future direct-charge path.
    • billing_countrystring
    • idempotency_keystringGenerated if omitted. Reusing a key returns the first checkout instead of starting another.
  • get_activation1 param

    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).

    Show parameters
    • order_idstringrequiredThe order_id returned by purchase.
  • topup_lookup5 params

    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.

    Show parameters
    • line_typestringrequired"us_prepaid" for a US phone line, "esim" for a travel eSIM.
    • phonestringUS phone number (for us_prepaid).
    • carrierstringCarrier name/id (for us_prepaid; see topup carriers).
    • iccidstringeSIM ICCID (for esim).
    • emailstringCustomer email (required for esim lookup).
  • topup_start8 params

    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.

    Show parameters
    • line_typestringrequired
    • product_idstringrequiredTop-up plan id from topup_lookup.
    • customer_emailstringrequired
    • phonestringUS phone (us_prepaid).
    • carrierstring
    • iccidstringeSIM ICCID (esim).
    • source_order_idstringOriginal eSIM order id (esim).
    • custom_amountnumberFor range/RTR plans only.
  • 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.

  • get_number_pricing

    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.

  • buy_numbers9 params

    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.

    Show parameters
    • countintegerrequiredHow many numbers.
    • billingstringrequired"daily" or "monthly". See get_number_pricing.
    • daysintegerDaily billing only: days to pay now (at least the minimum).
    • monthsintegerMonthly billing only: months to pay up front (at least the minimum).
    • voicebooleanAlso calls over SIP (costs more; must be enabled on the account).
    • line_historystringMonthly 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 b
    • area_codestringPreferred 3-digit US area code, if available.
    • zip_codestring5-digit US ZIP to pick the number's area, if available.
    • customer_referencestringYour own reference for this order; a repeat with the same reference returns the first order.
  • get_order1 param

    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.

    Show parameters
    • orderstringrequiredThe order_id or the customer_reference.
  • list_my_numbers3 params

    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.

    Show parameters
    • searchstringOptional: part of a number or a label to filter by.
    • limitintegerNumbers per page, default 100.
    • offsetintegerWhere to start; use next_offset from the previous page.
  • 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.

    Show parameters
    • numberstringOne of your numbers, e.g. "4234322309" or "+1 423 432 2309". Omit for all numbers.
    • sincestringISO 8601 timestamp; only messages received after it.
    • limitintegerDefault 50.
  • wait_for_message3 params

    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.

    Show parameters
    • numberstringOne of your numbers. Omit to watch every number on the account.
    • sincestringISO 8601; only a message received after this counts. Default: now.
    • timeout_secondsintegerHow long to wait, default 30.
  • send_message3 params

    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.

    Show parameters
    • fromstringrequiredOne of your numbers.
    • tostringrequiredThe destination number, e.g. "+1 212 555 0100".
    • messagestringrequiredThe text to send, up to 800 characters.

Checked by Serverdex with a plain initialize + tools/list call to mcp.meisimusa.com/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 18, 2026
Stars
1
Forks
0
Last push
Nov 17, 2026
License
MIT

TypeScriptai-agentsmcpmcp-servermodel-context-protocolphone-numbersipsmstelephonyus-phone-numbersvoice-ai

From the README

meisimusa-mcp The MCP (Model Context Protocol) server for MeiSIM USA. Two things in one server: 1. Real US phone numbers for your AI agent (API key). List the numbers on your account, read the texts they receive, wait for the next one, send texts, check the wallet and buy more numbers. The numbers are real carrier lines, not virtual numbers. 2. Travel eSIMs and retail US plans (no key). Search plans for about 200 countries, get a quote, pay by card on a Stripe page, get the install QR, top up a line. "Which of my numbers got a text in the last hour?" → read_messages "Wait for the clinic's reply on 423 432 2309 and read it back" → waitformessage "Text +1 212 555 0100 from my number: running ten minutes late" → send_message "I'm going to Italy for 10 days, get me 5GB" → searchplans, purchase, getactivation Connect Remote, nothing to install. Add https://mcp.meisimusa.com/mcp as a custom connector or HTTP MCP server. For the tools on your own numbers, send your API key on the connection: Without a key the retail tools still work and the number tools answer with where to apply. Local (stdio), for Claude Desktop, Cursor, Zed: Get an API key. Sign up at https://www.meisimusa.com/get-started.html. Every account passes an ID check or a review by a person before it gets a key: one that clears the automatic checks opens in minutes, any other is reviewed by a person, usually the same day.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://mcp.meisimusa.com/mcp

The most-starred Other servers in the index, with their live-check result.

ServerStarsLast pushLive check
Labelhead Artist Momentum114,594Nov 2026Working
World Monitor91,002Nov 2026Needs sign-in
Tldraw51,470Nov 2026Working
OpenSEO28,515Nov 2026Needs sign-in
Windows MCP11,833Nov 2026Local / not checked

MeiSIM USA: questions people ask

Is MeiSIM USA a remote or a local MCP server?
According to its entry in the official MCP registry, MeiSIM USA ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does MeiSIM USA need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is MeiSIM USA safe to use?
Looks healthy: MeiSIM USA is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is MeiSIM USA still maintained?
Active: the repository's last commit 5 days ago. Last push Nov 17, 2026, 1 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
What tools does MeiSIM USA expose?
16 tools as listed by the server itself during the live check, including search_plans, get_quote, get_ai_line_offer, search_us_numbers, purchase. The full list with parameters is in the Live check section above.
How do I add MeiSIM USA to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Other →

Add the badge to your site

Show visitors that MeiSIM USA is listed here — it’s also the link we check for a free listing.

MeiSIM USA — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-shauliko-meisimusa-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="MeiSIM USA — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![MeiSIM USA — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-shauliko-meisimusa-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-shauliko-meisimusa-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-shauliko-meisimusa-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-shauliko-meisimusa-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-shauliko-meisimusa-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-shauliko-meisimusa-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-shauliko-meisimusa-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).