Quartermaster eSIM

io.github.dvirmimon123-techPublished by GitHub account dvirmimon123-techv0.3.2Updated Nov 3, 2026

Agent-only store: AI agents search, quote and buy travel eSIM data plans for their users.

The publisher's own server: The Quartermaster

VerifiedStreamable HTTPWeb executableLocation & LifestyleAI & ML

Overview

Quartermaster eSIM's hosted MCP server (api.quartermasterhq.ai); no sign-in required; Streamable HTTP; 14 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
api.quartermasterhq.ai
Last checked

Installation

In SourceWeft

  1. Open Quartermaster eSIM in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.dvirmimon123-tech%2Fquartermaster/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "quartermaster-esim": {
      "type": "http",
      "url": "https://api.quartermasterhq.ai/mcp"
    }
  }
}

README

Quartermaster eSIM

A store built for AI agents to shop in, on behalf of the people they work for. Quartermaster sells prepaid travel eSIM data plans to AI agents over MCP. Your agent searches plans by country, checks the store's machine-readable policies, gets a quote, and buys within limits its human set in advance, then hands back the QR / LPA activation code.

The human stays in control. A person registers the agent with a spending mandate (per purchase, per day, per month, expiry) and funds a prepaid wallet themselves through a hosted payment page. The agent can never see card details, can never spend beyond the mandate or the wallet balance, and every purchase produces a signed receipt the human can verify. Within those limits the agent shops on its own: there is no storefront for people, because people are not the ones browsing.

Status: public sandbox. Search, quotes, wallet and purchase flows are live against a sandbox supplier; real eSIM fulfilment is being connected. Sandbox purchases return test activation codes.

Connect

Claude Code

sh
claude mcp add --transport http quartermaster https://api.quartermasterhq.ai/mcp

Claude Desktop / other stdio clients (via mcp-remote)

json
{  "mcpServers": {    "quartermaster": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.quartermasterhq.ai/mcp"] }  }}

Raw HTTP

sh
curl -s https://api.quartermasterhq.ai/mcp \  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Tools

ToolWhat it does
register_agentRegister an agent for a principal with a spending mandate (per transaction, day, month, expiry). Returns agent_key and, for a new principal, principal_key.
get_policiesMachine-readable refund, dispute, mandate and wallet rules, so an agent can reason about terms before buying.
search_plansSearch eSIM plans by country, region, data and validity.
get_quoteLock a price for a plan.
purchaseBuy with an idempotency key; enforces mandate and wallet; returns activation code and a signed receipt.
get_wallet / get_topup_linkPrincipal's prepaid wallet; hosted top-up link for the human to pay.
order_status, regenerate_activation, request_refund, verify_receiptAfter-sale: status, new activation code, refunds and disputes by policy, receipt verification.
rotate_principal_keyRotate the principal's ownership key.

Every decision comes back as {allowed, reason_code, human_readable}; refunds and disputes are resolved by written rules, not by a support desk.

Why agent-only

Other eSIM MCP servers help an agent compare plans. Quartermaster lets it finish the job: buy within a signed mandate, deliver the activation code, and keep a verifiable receipt.

Agents don't need a homepage. They need complete structured data, a stable API, explicit authority from their principal, and terms they can evaluate before acting. Quartermaster is designed around exactly that: one catalog behind every protocol, policies as data, and a hash-chained ledger with signed receipts for every transaction.

Contact

Suppliers and agent builders: [email protected]

Source: README.md at commit b8e5503

Tools

14

register_agent

Register agent and mandate

Create an agent identity bound to a principal, with a spending mandate (limits in minor units). Returns agent_key once; send it on every later call. The first agent of a new principal_id also receives principal_key (once): the principal owns the wallet, and every later register_agent for that principal_id must present principal_key (argument or X-Principal-Key header), else PRINCIPAL_KEY_REQUIRED. New agents are capped by the registration policy (see get_policies).

Parametersmandaterequiredagent_idrequiredprincipal_idrequiredprincipal_key

rotate_principal_key

Rotate the principal key

Replace your principal's principal_key. Needs your agent credentials and the current principal_key (argument or X-Principal-Key header). Returns the new key once; the old one stops working. Existing agents are unaffected. A principal registered before keys existed has none: any of its agents can call this without principal_key to mint the first one.

Parametersagent_idagent_keyprincipal_idprincipal_key

get_policies

Read store policies

Returns every policy as machine-readable JSON (mandate, refund, dispute, supplier trust, registration), the store terms and the product/agent JSON Schemas, so you can reason about terms before buying.

Parametersagent_idagent_keyprincipal_id

search_plans

Search eSIM plans

Search eSIM data plans from trusted suppliers. Filter by destination country (ISO 3166-1 alpha-2) or region, minimum data, validity and price. Results are sorted by final price unless sort says otherwise. Suppliers below the trust threshold are excluded and listed in excluded_suppliers.

Parameterssortlimitregioncountryagent_idcategoryagent_keymin_data_gbprincipal_idunlimited_onlymax_price_minormax_validity_days+2 more

get_quote

Get a binding quote

Lock the final price for one product for a short time (quote_ttl_seconds in store terms). Also returns a mandate pre-check and the refund terms, so you know before buying whether the purchase will be allowed.

Parametersagent_idagent_keyproduct_idrequiredprincipal_id

purchase

Purchase a quoted plan

Buy the product in a quote. Enforces the mandate and the wallet policy, holds the amount in the principal's wallet, orders from the supplier, debits the wallet, and returns the order with the eSIM delivery payload and a signed receipt. If the wallet is short, fails with WALLET_INSUFFICIENT_FUNDS and a ready top-up link for the principal. idempotency_key is required: reusing it returns the original order and never charges twice.

Parametersagent_idquote_idrequiredagent_keyprincipal_ididempotency_keyrequired

get_wallet

Principal wallet

Balance, available funds (balance minus pending holds), open top-up links, recent top-ups and recent ledger entries of the wallet of the principal you act for. Shared by all of the principal's agents. Amounts in minor units.

Parameterslimitagent_idagent_keyprincipal_id

order_status

Order status

Current order state, eSIM delivery payload, activation and data usage from the supplier, receipts and disputes.

Parametersagent_idorder_idrequiredagent_keyprincipal_id

regenerate_activation

Reissue the eSIM activation code

For one of your own delivered orders whose activation code (QR / LPA) does not install: asks the supplier for a fresh code and returns the new delivery payload. The previous code may stop working. Not every supplier supports it (NOT_SUPPORTED_BY_SUPPLIER); then open a dispute with reason not_working.

Parametersagent_idorder_idrequiredagent_keyprincipal_id

request_refund

Request a refund or open a dispute

Reasons "unused" and "changed_plans" are voluntary refunds under the refund policy. Reasons "not_delivered", "not_working" and "duplicate_purchase" open a dispute under the dispute policy, which can refund fully, partially, reject, or escalate to a human. Denials return error.code = the policy reason_code.

Parametersreasonrequireddetailsagent_idorder_idrequiredagent_keyprincipal_id

verify_receipt

Verify a receipt

Check a receipt's signature and that it matches its hash-chained ledger entry.

Parametersreceiptrequiredagent_idagent_keyprincipal_id

sandbox_simulate_topup_payment

Sandbox: principal pays a top-up link

Sandbox only. Acts as the principal paying a get_topup_link URL: the mock provider sends a PayPlus-format IPN through the same webhook path production uses, and the wallet is credited. outcome "declined" simulates a failed card.

Parametersoutcomeagent_idtopup_idrequiredagent_keyprincipal_id

sandbox_simulate_activation

Sandbox: simulate eSIM activation

Sandbox only. Marks the order's eSIM as installed and used, as if the traveler activated it. Use it to exercise refund and dispute rules.

Parametersagent_idorder_idrequiredagent_keydata_used_mbprincipal_id

Version history

2
  1. v0.3.2LatestNov 3, 2026
  2. v0.3.1Nov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Quartermaster integrations