Gorse

DOT MCP Server enables AI-driven eSIM activation and provisioning through a standardized MCP interface. It exposes JSON-RPC 2.0 endpoints that let AI assistants like ChatGPT or Gemini trigger user registration, invoice generation, payment verification, and live eSIM provisioning via the OXIO network, delivering QR codes and phone numbers for immediate global connectivity.

How to use

You interact with the MCP server through an MCP client or AI assistant that supports JSON-RPC 2.0. Use the available tools to explore services, calculate pricing, compare plans, or activate an eSIM after payment is completed. The flow is designed so new users can be created automatically from AI conversations, invoices are generated and sent via Stripe, and eSIM provisioning happens in real time through OXIO. You will receive a QR code and a phone number by email once activation completes.

How to install

Prerequisites: you should have a suitable MCP client or development environment that can issue JSON-RPC 2.0 requests to the MCP server at the provided endpoint.

1. Prepare a client environment for HTTP MCP calls.

2. Install necessary tooling to interact with the MCP endpoint (examples below use curl; adapt to your language of choice).

3. Ensure network access to the MCP server URL: https://mcp.dotmobile.app/mcp.

# Simple HTTP client example (curl)
curl -X POST https://mcp.dotmobile.app/mcp/messages \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"activate_esim","arguments":{"email":"user@example.com","firebase_uid":"user_firebase_uid_123"}}}'

Additional setup notes

If you plan to run a local MCP server instance for development or testing, follow the standard deployment approach for a Python-based API server that implements the MCP 2.0 protocol, ensuring you expose the correct MCP endpoint and maintain secure authentication with Firebase. Prepare to monitor rate limiting, queue management, and payment verification via Stripe webhooks.

Extra notes

The MCP server is designed to provide unified access to MCP endpoints for AI-assisted eSIM activation, including info, messages (JSON-RPC 2.0 tool execution), and docs endpoints. Use the primary MCP URL to interact with the server and access live provisioning features.

Available tools

calculate_pricing

Dynamically calculate pricing for service bundles based on selected services

search_services

Discover available telecommunications services in the MCP catalog

get_service_details

Retrieve detailed information about a specific service or plan

compare_memberships

Provide side-by-side comparisons of membership plans

activate_esim

Complete eSIM activation including payment verification and provisioning