Xpress Flow Systems MCP
An official MCP server enabling AI agents to check domain availability, order domains, eSIMs, and proxies, and manage orders via payment links or a prepaid wallet without requiring user sign-up.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://www.xpressflowsystems.com.ng/api/mcpWhat you can do with it
- Check domain name availability
- Order eSIM data plans and phone numbers
- Purchase proxy services
- Manage prepaid wallet deposits and purchases
Source and maintenance
Protocol and capabilities
- Server
- xpress 1.2.0
- MCP protocol
- 2025-06-18
- Tools
- 16 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
16 advertised
check_domain_availability
Check whether one domain name is free to register. Answers from the public registry for that ending: available, unavailable (taken) or unknown (that ending cannot be checked here). Takes one full name such as yourbrand.com.ng. When it can be ordered online, gives the first-year price. Prices are in US dollars outside Nigeria and in naira in Nigeria; pass currency to choose.
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "One full domain name, for example yourbrand.com.ng."
},
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN. By default prices are in US dollars outside Nigeria and in naira inside Nigeria, from where the request comes from."
}
},
"additionalProperties": false
}{
"title": "Check a domain name",
"readOnlyHint": true,
"openWorldHint": true
}list_esim_locations
List every country and region we sell eSIM data plans for, with their codes. Regions (for example Europe or Global) cover many countries in one eSIM.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"title": "List eSIM destinations",
"readOnlyHint": true,
"openWorldHint": true
}search_esim_plans
eSIM data plans for one destination, cheapest first, with prices. No sign-up: the person orders, pays, and gets an eSIM QR code. Give a country or region name or code, for example "United Kingdom", "GB" or "Europe". Each plan has an order_url: our own order page for the person. Prices are in US dollars outside Nigeria and in naira in Nigeria; pass currency to choose.
{
"type": "object",
"required": [
"location"
],
"properties": {
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN. By default prices are in US dollars outside Nigeria and in naira inside Nigeria, from where the request comes from."
},
"location": {
"type": "string",
"description": "Country or region name or code, for example United Kingdom, GB, Europe or europe."
}
},
"additionalProperties": false
}{
"title": "Search eSIM plans",
"readOnlyHint": true,
"openWorldHint": true
}search
Search what Xpress sells: eSIM destinations by name. Returns ids to pass to fetch.
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Words to search for, for example \"japan esim\"."
}
},
"additionalProperties": false
}{
"title": "Search the catalogue",
"readOnlyHint": true,
"openWorldHint": true
}fetch
Full details for one id returned by search, for example esim:GB (every plan and price for that destination). Prices are in US dollars outside Nigeria and in naira in Nigeria; pass currency to choose.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "An id from search, for example esim:GB."
},
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN. By default prices are in US dollars outside Nigeria and in naira inside Nigeria, from where the request comes from."
}
},
"additionalProperties": false
}{
"title": "Fetch catalogue details",
"readOnlyHint": true,
"openWorldHint": true
}search_phone_plans
eSIMs with a real carrier phone number (calls, texts and data), with prices. Optional country: US, VN, AU, MN, MV, EU (Europe) or GLOBAL. Each plan has an order_url for the person. Non-refundable once bought. Prices are in US dollars outside Nigeria and in naira in Nigeria; pass currency to choose.
{
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "Optional: US, VN, AU, MN, MV, EU or GLOBAL."
},
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN. By default prices are in US dollars outside Nigeria and in naira inside Nigeria, from where the request comes from."
}
},
"additionalProperties": false
}{
"title": "Phone-number eSIMs",
"readOnlyHint": true,
"openWorldHint": true
}create_domain_order
Start an order to register an available domain for a person. This does not charge anyone. It returns an approval_url that the person must open and pay (in US dollars outside Nigeria, in naira in Nigeria); the name is held for 60 minutes. Send approval_url to your user and wait. Poll get_order_status afterwards.
{
"type": "object",
"required": [
"domain",
"customer_name",
"customer_email",
"customer_phone",
"address",
"city",
"state",
"country",
"accept_terms"
],
"properties": {
"city": {
"type": "string",
"description": "City."
},
"state": {
"type": "string",
"description": "State or region."
},
"domain": {
"type": "string",
"description": "The available domain to register."
},
"address": {
"type": "string",
"description": "Street address of the registrant."
},
"country": {
"type": "string",
"description": "Country, for example Nigeria."
},
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN, the currency the person pays in. By default US dollars outside Nigeria and naira in Nigeria, from where the request comes from."
},
"accept_terms": {
"type": "boolean",
"description": "Set true only if your user has agreed to the Terms of Use and Privacy Policy on this website."
},
"organisation": {
"type": "string",
"description": "Optional organisation name."
},
"customer_name": {
"type": "string",
"description": "Full name of the person who will own the domain."
},
"customer_email": {
"type": "string",
"description": "Their email address."
},
"customer_phone": {
"type": "string",
"description": "A phone number we can reach, for example 08012345678."
},
"email_verification_token": {
"type": "string",
"description": "verification_token from verify_email_code for this email (required while email checks are on)."
}
},
"additionalProperties": false
}{
"title": "Start a domain order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}get_order_status
Look up an order made with create_domain_order, create_esim_order or create_proxy_order. Statuses: pending_payment (waiting for payment; for a phone-number order held for an ID check, payment_url appears once approved and nothing is charged before that), paid, activating (paid and being prepared, delivered within 10 minutes; if it needs more time the note says so and the buyer is emailed, and they can ask for a full refund before delivery), delivered, failed, refunded. Delivered orders carry the eSIM activation details or the proxy lines. For domains, delivered means registered.
{
"type": "object",
"required": [
"reference",
"token"
],
"properties": {
"token": {
"type": "string",
"description": "The access token: the last part of status_url."
},
"reference": {
"type": "string",
"description": "Order reference such as XF-7K3Q9DFA."
}
},
"additionalProperties": false
}{
"title": "Get order status",
"readOnlyHint": true
}create_esim_order
Start an eSIM purchase for a person. Phone-number plans need name, accept_aup: true and a real (not temporary) email, and are limited to 3 numbers per person. Any number past 3 needs customer_phone and id_document and waits for an ID check (status pending_payment with no payment_url yet, nothing charged) before payment_url is given. This does not charge anyone: it returns payment_url (card, bank transfer or crypto) for the person to pay, in US dollars outside Nigeria and in naira in Nigeria. After a verified payment the eSIM is delivered within 10 minutes; if it needs more time the buyer is emailed and can ask for a full refund before delivery. Poll get_order_status with reference and status_token. Use plan_code and location from search_esim_plans, or phone_plan_code from search_phone_plans.
{
"type": "object",
"required": [
"email",
"accept_terms"
],
"properties": {
"name": {
"type": "string",
"description": "With phone_plan_code: the person's full name (first and last)."
},
"email": {
"type": "string",
"description": "Required: the person's email, for their receipt and order details (the eSIM)."
},
"country": {
"type": "string",
"description": "Optional: the payer's two-letter country. Outside Nigeria (NG) they pay in US dollars. Defaults to where the request comes from."
},
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN. By default prices are in US dollars outside Nigeria and in naira inside Nigeria, from where the request comes from."
},
"location": {
"type": "string",
"description": "Destination code from search_esim_plans, for example US. Not needed with phone_plan_code."
},
"plan_code": {
"type": "string",
"description": "plan_code from search_esim_plans."
},
"accept_aup": {
"type": "boolean",
"description": "Required true with phone_plan_code: your user agreed to the Acceptable Use Policy (/acceptable-use): no spam, scams, impersonation, bulk SMS or robocalls; a violation cancels the number with no refund."
},
"id_document": {
"type": "string",
"description": "Only when asked (VERIFICATION_REQUIRED): data URL (data:image/jpeg;base64,... or application/pdf) of a passport, driving licence or national ID, under 3 MB. Kept private."
},
"accept_terms": {
"type": "boolean",
"description": "Set true only if your user agreed to the Terms of Use and Privacy Policy on this website."
},
"customer_phone": {
"type": "string",
"description": "Only when asked (VERIFICATION_REQUIRED): the person's own phone number."
},
"phone_plan_code": {
"type": "string",
"description": "plan_code from search_phone_plans, for an eSIM with a phone number."
},
"email_verification_token": {
"type": "string",
"description": "verification_token from verify_email_code for this email (required while email checks are on)."
}
},
"additionalProperties": false
}{
"title": "Start an eSIM purchase",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}list_proxy_products
Proxy products with packs and prices, cheapest first. Each pack has an offer_id for create_proxy_order. Prices are in US dollars outside Nigeria and in naira in Nigeria; pass currency to choose.
{
"type": "object",
"properties": {
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN. By default prices are in US dollars outside Nigeria and in naira inside Nigeria, from where the request comes from."
}
},
"additionalProperties": false
}{
"title": "Proxy products",
"readOnlyHint": true,
"openWorldHint": true
}create_proxy_order
Start a proxy purchase for a person. This does not charge anyone: it returns payment_url for the person to pay, in US dollars outside Nigeria and in naira in Nigeria. After a verified payment the proxies are issued within 10 minutes. Poll get_order_status with reference and status_token.
{
"type": "object",
"required": [
"product",
"gb",
"offer_id",
"email",
"accept_terms"
],
"properties": {
"gb": {
"type": "number",
"description": "Pack size (GB, or Mbps for a speed tier)."
},
"email": {
"type": "string",
"description": "Required: the person's email, for their receipt and order details (the lines)."
},
"country": {
"type": "string",
"description": "Optional: the payer's two-letter country. Outside Nigeria (NG) they pay in US dollars. Defaults to where the request comes from."
},
"product": {
"type": "string",
"description": "Product id from list_proxy_products."
},
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN. By default prices are in US dollars outside Nigeria and in naira inside Nigeria, from where the request comes from."
},
"offer_id": {
"type": "string",
"description": "offer_id of the pack from list_proxy_products."
},
"accept_terms": {
"type": "boolean",
"description": "Set true only if your user agreed to the Terms of Use and Privacy Policy on this website."
},
"target_country": {
"type": "string",
"description": "Optional: two-letter country the proxy lines should exit from."
},
"email_verification_token": {
"type": "string",
"description": "verification_token from verify_email_code for this email (required while email checks are on)."
}
},
"additionalProperties": false
}{
"title": "Start a proxy purchase",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}create_cart_order
Start one purchase for several eSIMs and proxy packs together: one payment_url for the whole total, in US dollars outside Nigeria and in naira in Nigeria. This does not charge anyone. After a verified payment every item is delivered within 10 minutes. Returns each item reference with its own status_url. Poll get_cart_status with reference and status_token.
{
"type": "object",
"required": [
"items",
"email",
"accept_terms"
],
"properties": {
"email": {
"type": "string",
"description": "Required: the person's email, for receipts and order details."
},
"items": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"description": "Items: { kind: \"esim\", location, plan_code, qty } or { kind: \"proxy\", product, gb, offer_id, target_country, qty }. qty 1 to 5."
},
"country": {
"type": "string",
"description": "Optional: the payer's two-letter country. Outside Nigeria (NG) they pay in US dollars."
},
"currency": {
"enum": [
"USD",
"NGN"
],
"type": "string",
"description": "Optional: USD or NGN. By default prices are in US dollars outside Nigeria and in naira inside Nigeria, from where the request comes from."
},
"accept_terms": {
"type": "boolean",
"description": "Set true only if your user agreed to the Terms of Use and Privacy Policy on this website."
},
"email_verification_token": {
"type": "string",
"description": "verification_token from verify_email_code for this email (required while email checks are on)."
}
},
"additionalProperties": false
}{
"title": "Start a cart purchase",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}get_cart_status
Look up a cart made with create_cart_order: the cart status and each item with its own status_url. Statuses: pending_payment (waiting for payment; for a phone-number order held for an ID check, payment_url appears once approved and nothing is charged before that), paid, activating (paid and being prepared, delivered within 10 minutes; if it needs more time the note says so and the buyer is emailed, and they can ask for a full refund before delivery), delivered, failed, refunded. Delivered orders carry the eSIM activation details or the proxy lines.
{
"type": "object",
"required": [
"reference",
"status_token"
],
"properties": {
"reference": {
"type": "string",
"description": "Cart reference (XC-...)."
},
"status_token": {
"type": "string",
"description": "status_token from create_cart_order."
}
},
"additionalProperties": false
}{
"title": "Cart status",
"readOnlyHint": true,
"openWorldHint": true
}request_email_code
Step 1 before any create_*_order: email a 6-digit code to the buyer. Ask your user for the code from that email (it expires in 10 minutes; a new one can be sent after 60 seconds, at most 5 an hour).
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "The buyer's email address."
}
},
"additionalProperties": false
}{
"title": "Email a confirmation code",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}verify_email_code
Step 2: check the 6-digit code your user read from their email. Returns verification_token (valid 24 hours); pass it as email_verification_token to create_domain_order, create_esim_order or create_proxy_order with the same email. 5 tries per code.
{
"type": "object",
"required": [
"email",
"code"
],
"properties": {
"code": {
"type": "string",
"description": "The 6-digit code."
},
"email": {
"type": "string",
"description": "The same email the code was sent to."
}
},
"additionalProperties": false
}{
"title": "Confirm the email code",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}create_wallet
Create an empty Xpress wallet (no sign-up, no free credit). Returns a 32-character wallet code and an xk_live_ API key, shown once. Fund it with create_deposit on /api/mcp/wallet, then buy domains and eSIMs from the wallet balance within the caps the wallet owner sets.
{
"type": "object",
"required": [
"accept_terms"
],
"properties": {
"accept_terms": {
"type": "boolean",
"description": "Set true only if your user agreed to the Terms of Use and Privacy Policy on this website."
}
},
"additionalProperties": false
}{
"title": "Create a wallet",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1139 ms
- 95th percentile latency
- 1139 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1139 ms · metadata changed · 16 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http xpress-flow-systems-mcp https://www.xpressflowsystems.com.ng/api/mcpCodex
codex mcp add xpress-flow-systems-mcp --url https://www.xpressflowsystems.com.ng/api/mcpCursor
{
"mcpServers": {
"xpress-flow-systems-mcp": {
"url": "https://www.xpressflowsystems.com.ng/api/mcp"
}
}
}Cline
{
"mcpServers": {
"xpress-flow-systems-mcp": {
"type": "streamableHttp",
"url": "https://www.xpressflowsystems.com.ng/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"xpress-flow-systems-mcp": {
"type": "http",
"url": "https://www.xpressflowsystems.com.ng/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http xpress-flow-systems-mcp https://www.xpressflowsystems.com.ng/api/mcpClaude Desktop
{
"mcpServers": {
"xpress-flow-systems-mcp": {
"url": "https://www.xpressflowsystems.com.ng/api/mcp"
}
}
}Windsurf
{
"mcpServers": {
"xpress-flow-systems-mcp": {
"serverUrl": "https://www.xpressflowsystems.com.ng/api/mcp"
}
}
}Let your agent find its tools
Find servers like Xpress Flow Systems MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Xpress Flow Systems MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.