gorse-mcp服务器

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# DOT Global Connectivity

![DOT](https://img.shields.io/badge/Status-Live-green) ![Ethereum](https://img.shields.io/badge/Ethereum-Mainnet-blue) ![Version](https://img.shields.io/badge/Version-3.1.1-brightgreen) ![MCP](https://img.shields.io/badge/MCP-2.0-purple)

## 🤖 AI Integration - NEW!

**Activate eSIMs by simply talking to ChatGPT or Gemini AI**

Users can now discover and activate DOTM eSIMs entirely through natural conversation:

```
👤 USER → ChatGPT: "I need a Global Data eSIM for my trip to Europe"

🤖 ChatGPT: "I can help you activate a DOTM eSIM! I've sent a $1 
            invoice to your email. After payment, you'll have instant 
            global connectivity."

✅ RESULT: eSIM activated, QR code delivered, ready to travel!
```

### Trigger Phrases
- **"Global Data eSIM"** - Discover DOT through ChatGPT
- **"DOT eSIM"** - Activate via Gemini AI or ChatGPT

### How It Works
1. **Conversation-Based Discovery** - No website needed
2. **Automatic Account Creation** - Seamless onboarding
3. **Email-Based Payment** - Simple $1 Stripe invoice
4. **Instant Activation** - eSIM ready in <5 minutes
5. **QR Code Delivery** - Install and connect immediately

**Powered by Model Context Protocol (MCP) - [Learn More](#-ai-assistant-integration-mcp)**

---

## 🌐 Full MVNO Framework

DOTM Platform is a next-generation telecommunications service combining global eSIM connectivity with blockchain rewards and AI-driven automation.

**Code, APIs and App Available for FREE. $1/month license for globally connected active users. Ask for above 100TPH access.**

### What We Provide
- ✅ **Global eSIM Connectivity** - 190+ countries via OXIO network
- ✅ **AI-Powered Activation** - ChatGPT & Gemini integration
- ✅ **Blockchain Rewards** - DOTM token on Ethereum Mainnet
- ✅ **Automated Invoicing** - Stripe payment processing
- ✅ **Enterprise Security** - Rate limiting, Firebase auth, encryption
- ✅ **Full MVNO** - Complete telecommunications stack

We provide global eSIM connectivity, automation, network services intelligence and network optimization features through a unified ecosystem in a public cloud. Our data servers are located solely in North America: N.Virginia, USA and in Montreal, Canada. We use Full MVNO type of connectivity in the USA, Mexico and in Canada soon hopefully.

### Technology Stack
Firebase authentication, Gemini for AI, NeonDB for Postgresql databases, Resend for email delivery, ElevenLabs for voice synthesis, Bitchat for fallback connectivity, Ethereum blockchain integration, and **Model Context Protocol (MCP)** for AI assistant integration. Full list of integrations below.

### 🚀 Live Platform

- **Main Platform**: [gorse.dotmobile.app](https://gorse.dotmobile.app)
- **MCP Server**: [mcp.dotmobile.app](https://mcp.dotmobile.app)
- **API Documentation**: [gorse.dotmobile.app/mcp](https://gorse.dotmobile.app/mcp)

## 💎 DOTM Token (Ethereum Mainnet)

**Contract Address**: `0xF57ab8DEE7ebE3686DB8Bf89E8aCc15E94B97A8D`

### Token Economics
- **Token Symbol**: DOTM
- **Network**: Ethereum Mainnet
- **Max Supply**: 10,333,333 DOTM
- **Current Supply**: (mint-on-demand)
- **Decimals**: 18

### Reward System
- **10.33% Cashback**: Earn DOTM tokens on all service purchases
- **Usage Rewards**: Additional tokens based on service utilization
- **Founding Member Benefits**: Special perks for early adopters

### Smart Contract Features
- **ERC-20 Standard**: Full compatibility with Ethereum ecosystem
- **Mintable**: Owner-controlled token distribution
- **Reward Automation**: Automatic distribution based on platform activity
- **Supply Cap**: Fixed maximum supply with deflationary mechanics

## 🌍 Core Services

### Global eSIM Connectivity
- **Global Data Package**: **$20.00 USD for 10GB**
- **190+ Countries**: Worldwide coverage through OXIO network
- **Instant Activation**: Immediate service provisioning
- **No Roaming Fees**: Transparent, fixed pricing

### Membership Plans
- **Basic Membership**: **$24.00 USD/year**
  - Global data access
  - Standard support
  - DOTM token rewards
  - Basic network features

- **Full Membership**: **$66.00 USD/year**
  - Unlimited talk & text
  - Priority support
  - Enhanced token rewards
  - Premium network features
  - Beta access priority

### Beta Program
- **Email Approval Workflow**: Admin-managed access control
- **Phone Number Assignment**: Random North American numbers via OXIO
- **QR Code Generation**: RESIN data and phone access codes
- **Profile Integration**: Complete beta management in user profiles
- **OXIO Integration**: Automatic user provisioning and GroupID management

## 🔧 Platform Architecture

### Backend Infrastructure
- **Flask REST API**: Core application with Flask-RESTX documentation
- **PostgreSQL Database**: Connection pooling and data management
- **Firebase Authentication**: Secure user identity management
- **Stripe Integration**: Complete payment processing infrastructure
- **OXIO API**: Global eSIM and connectivity services
- **Ethereum Integration**: Web3.py for blockchain interactions
- **Resend Email API**: Professional email delivery with 99.9% deliverability

### Key Integrations
- **Firebase Admin SDK**: Server-side authentication and user management
- **Stripe Payments**: Subscription management and billing
- **Network Services API**: eSIM provisioning and connectivity management
- **Ethereum Mainnet**: DOTM token rewards and transactions
- **Resend Email API**: Professional email delivery and notifications
- **ElevenLabs**: Voice synthesis for personalized interactions
- **OpenAI API**: AI-powered customer support

## 🎙️ Advanced Communication Features

### Resend Email Service Integration
- **Professional Email Delivery**: High-deliverability email service with 99.9% uptime
- **Verified Domain**: emails sent from @dotmobile.app with proper SPF/DKIM authentication
- **Transactional Emails**: Magic link authentication, welcome messages, and notifications
- **Template Support**: HTML email templates with dynamic content injection
- **Delivery Analytics**: Real-time email delivery tracking and bounce management
- **API Integration**: RESTful email API with automatic failover to SMTP backup
- **Scalable Infrastructure**: Handle high-volume email campaigns and notifications

### ElevenLabs.io Voice Synthesis
- **Multilingual Support**: Welcome messages in English, Spanish, and French
- **Personalized Messages**: Dynamic user-specific welcome audio content
- **Premium Voices**: High-quality neural voice synthesis (default: Rachel voice)
- **Custom Voice Settings**: Adjustable stability, similarity boost, and style parameters
- **Real-time Generation**: On-demand text-to-speech conversion for user interactions
- **Integration**: Seamless voice messages for onboarding and notifications

### Bitchat Encrypted Messaging
- **Zero Registration**: No accounts, emails, or phone numbers required
- **Military-Grade Encryption**: X25519 key exchange, AES-256-GCM, Ed25519 signatures
- **Mesh Networking**: Bluetooth LE peer-to-peer communication with store-and-forward capability
- **Privacy First**: Ephemeral messages, emergency triple-tap data wipe
- **Battery Optimized**: Adaptive power modes with intelligent message compression (LZ4)
- **Offline Operation**: Complete functionality without internet or cellular connectivity
- **Cover Traffic**: Timing obfuscation and dummy messages to prevent traffic analysis

### Model Context Protocol (MCP) Server 🆕
**Revolutionary AI-Driven eSIM Activation**

The DOTM Platform features a production-ready MCP server that enables ChatGPT and Gemini AI to activate eSIMs through natural conversation.

#### Key Features
- ✅ **JSON-RPC 2.0 Protocol**: Latest MCP specification (2024-11-05)
- ✅ **5 AI Tools Available**: Calculate pricing, search services, compare plans, activate eSIMs
- ✅ **Automatic User Registration**: New users created seamlessly from AI conversations
- ✅ **Automatic Invoice Generation**: Stripe invoices sent when payment needed ($1 for eSIM beta)
- ✅ **Rate Limiting**: 100 activations/hour with intelligent queue management
- ✅ **Real-Time ETA**: Queue position and wait time estimation
- ✅ **Privacy-First Design**: Zero user data exposure to AI assistants
- ✅ **OXIO Integration**: Live eSIM provisioning and phone number assignment

#### Conversation Flow
```
1. User: "I want a Global Data eSIM" 
   ↓
2. AI calls MCP server → Checks authentication
   ↓
3. Server creates account (if new user)
   ↓
4. Server checks payment → Sends $1 Stripe invoice
   ↓
5. User pays invoice via email
   ↓
6. User: "I paid the invoice"
   ↓
7. AI calls MCP server → Payment verified
   ↓
8. Server activates eSIM via OXIO
   ↓
9. QR code + phone number sent to user's email
   ↓
10. User installs eSIM and travels globally!
```

#### Security & Performance
- **Rate Limit**: 100 activations per hour (configurable)
- **Queue Management**: Position tracking with accurate ETAs
- **Firebase Auth**: Enterprise-grade user authentication
- **Stripe Payment**: Automatic invoice generation and verification
- **Comprehensive Logging**: Full audit trail for debugging and monitoring

#### Unified MCP Endpoints
- **Info**: `GET /mcp` - Server capabilities and version
- **Messages**: `POST /mcp/messages` - JSON-RPC 2.0 tool execution
- **Docs**: `GET /mcp/docs` - Interactive documentation

#### Available AI Tools
1. **calculate_pricing** - Dynamic cost calculations for service bundles
2. **search_services** - Discover available telecommunications services
3. **get_service_details** - Detailed information about specific services
4. **compare_memberships** - Side-by-side plan comparisons
5. **activate_esim** - Complete eSIM activation with payment verification ⭐

#### Testing
Comprehensive test suites validate the entire AI integration:
- ✅ Invocation phrase tests ("Global Data eSIM", "DOT eSIM")
- ✅ ChatGPT integration tests (6 test cases)
- ✅ Gemini AI integration tests (7 test cases)
- ✅ End-to-end activation workflow
- ✅ Rate limiting and queue management
- ✅ Payment verification and invoice generation

## 📱 Beta Approval System

### User Flow
1. **Request Access**: Users submit beta requests through their Profile page
2. **Admin Notification**: Automated email with approve/reject links
3. **OXIO Integration**: Phone number assignment and user provisioning
4. **QR Code Generation**: Service activation codes and RESIN data
5. **Profile Display**: Phone numbers and service details in user interface

### Technical Features
- **Email Workflow**: HTML notifications with one-click approval
- **Random Phone Generation**: North American area codes and numbers
- **GroupID Management**: Unique service identifiers for organization
- **Database Tracking**: Complete request history and status management
- **API Endpoints**: RESTful interfaces for beta management

### API Endpoints
- `POST /api/beta-request` - Submit beta access request
- `GET /api/beta-approve/<id>` - Admin approval endpoint
- `GET /api/beta-reject/<id>` - Admin rejection endpoint
- `GET /api/beta-status` - Check user beta status
- `GET /api/user-phone-numbers` - Retrieve phone numbers with QR codes

## 💰 Pricing Structure

| Service | Price | Billing | Features |
|---------|-------|---------|-----------|
| **Global Data** | **$20.00 USD** | Per 10GB | Worldwide coverage, instant activation |
| **Basic Membership** | **$24.00 USD** | Annual | Global access, standard support, token rewards |
| **Full Membership** | **$66.00 USD** | Annual | Unlimited features, priority support, enhanced rewards |
| **Network Security** | $5.00 USD | Monthly | VPN access, threat protection |
| **VPN Access** | $8.00 USD | Monthly | Global server network, unlimited bandwidth |
| **Priority Routing** | $6.00 USD | Monthly | Optimized network paths |
| **DOTM Metal Card** | $99.99 USD | One-time | Physical collectible, founding member status |

### Cost Calculator
- **Free Tier**: $0/month (Beta access only)
- **Basic Plan**: ~$2/month (Basic membership)
- **Premium Plan**: ~$5.50/month (Full membership)
- **Maximum Configuration**: ~$30-40/month (All features enabled)

### API Access Pricing (Subject to Change)

For developers integrating with the DOTM Platform API:

| Tier | TPH Limit | Price | Billing | Notes |
|------|-----------|-------|---------|-------|
| **Free** | ≤100 TPH | **$0** | N/A | All API endpoints included |
| **Paid** | >100 TPH | **$1.00 USD** | Per active user/month | Billed in arrears |

**TPH** = Transactions Per Hour (total API requests across all endpoints)

**Important Notes:**
- Network access (eSIM, data packages) charged separately per service pricing above
- See [TERMS_OF_SERVICE.md](https://github.com/dataontap/gorse/blob/HEAD/TERMS_OF_SERVICE.md) for complete API terms
- Pricing subject to change with 30 days notice
- Contact **rbm@dotmobile.app** for enterprise pricing

## 🛡️ Security & Privacy

### Privacy Protection
- **Zero User Data Exposure**: MCP server only exposes public service information
- **Data Isolation**: Strict separation between user data and public APIs
- **Compliant Error Handling**: Generic responses without system internals
- **Regular Audits**: Quarterly compliance and security reviews

### Security Features
- **HTTPS/TLS Encryption**: All communications encrypted end-to-end
- **Firebase Authentication**: Industry-standard identity management
- **Rate Limiting**: API abuse protection and traffic management
- **Input Validation**: Comprehensive parameter sanitization
- **Audit Logging**: Complete action tracking and compliance records

## 🤖 AI Assistant Integration (MCP)

### Activate eSIMs via ChatGPT or Gemini

Your users can now activate eSIMs by simply talking to their favorite AI assistant:

**Example Conversation:**
```
👤 USER: "I'm traveling to Japan next week and need mobile data. 
         I heard about Global Data eSIM - can you help?"

🤖 ChatGPT: "I can definitely help you get a DOTM Global Data eSIM 
            for your trip to Japan! Let me set that up for you..."
            
            [Calls DOTM MCP Server]

💾 DOTM: Creates account + Sends $1 Stripe invoice to user@email.com

🤖 ChatGPT: "I've created your DOTM account and sent a $1 invoice to 
            your email. Once you pay it, I'll activate your eSIM with 
            a phone number and data access for Japan!"

📧 USER: [Receives email, pays $1 via Stripe]

👤 USER: "I paid the invoice!"

🤖 ChatGPT: [Calls DOTM MCP Server again]

💾 DOTM: Payment verified ✓ → Activates eSIM → Assigns +1-555-123-4567

🤖 ChatGPT: "Perfect! Your DOTM eSIM is now active! 
            📱 Phone Number: +1-555-123-4567
            📧 Check your email for the QR code to install the eSIM
            🌏 You'll have data coverage throughout Japan
            
            Have an amazing trip!"

✅ USER: Scans QR code, installs eSIM, lands in Japan with connectivity!
```

### MCP Integration for Developers

**Test the MCP Server:**
```bash
# Check server status and capabilities
curl https://gorse.dotmobile.app/mcp

# Call the activate_esim tool via JSON-RPC 2.0
curl -X POST https://gorse.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"
      }
    }
  }'

# Response: Invoice sent or eSIM activated (depending on payment status)
```

**Rate Limit Monitoring:**
```bash
# Get current rate limit statistics
curl https://gorse.dotmobile.app/mcp | jq

# Example response shows:
# - Current activations: 87/100
# - Available slots: 13
# - Capacity used: 87.0%
# - Queue status: Empty
```

### JSON-RPC API Integration

**Note**: The API now uses JSON-RPC 2.0 protocol. Legacy REST endpoints have been removed.

### Python Integration
```python
import requests

BASE_URL = "https://gorse.dotmobile.app/mcp/messages"

# Fetch service catalog using JSON-RPC
response = requests.post(BASE_URL, json={
    "jsonrpc": "2.0",
    "id": 1,
    "method": "resources/read",
    "params": {"uri": "dotm://services/catalog"}
})
services = response.json()["result"]["contents"][0]["text"]

# Calculate pricing using tools
pricing_response = requests.post(BASE_URL, json={
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "calculate_pricing",
        "arguments": {
            "service_ids": ["basic_membership", "network_security_basic"]
        }
    }
})

result = pricing_response.json()["result"]["content"][0]["text"]
print(result)
```

### JavaScript Integration
```javascript
const BASE_URL = 'https://gorse.dotmobile.app/mcp/messages';

async function callMCP(method, params = {}) {
  const response = await fetch(BASE_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: Math.floor(Math.random() * 1000),
      method,
      params
    })
  });
  return response.json();
}

// Fetch service catalog
const catalog = await callMCP('resources/read', {
  uri: 'dotm://services/catalog'
});
console.log('Services:', catalog.result.contents[0].text);

// Calculate pricing
const pricing = await callMCP('tools/call', {
  name: 'calculate_pricing',
  arguments: { service_ids: ['full_membership', 'network_vpn_access'] }
});
console.log('Pricing:', pricing.result.content[0].text);
```

## 📊 Service Categories

### 1. Connectivity Services
- **Global eSIM**: Worldwide mobile data access
- **Data Packages**: 10GB packages at $20 USD
- **Beta Programs**: Early access to new features
- **Network Coverage**: 190+ countries supported

### 2. Membership Plans
- **Basic**: $24/year - Essential connectivity features
- **Full**: $66/year - Premium features and unlimited access
- **Beta**: Free - Early access and testing privileges

### 3. Network Features (Monthly Add-ons)
- **Network Security**: $5/month - Advanced threat protection
- **VPN Access**: $8/month - Global server network
- **Priority Routing**: $6/month - Optimized network paths
- **Network Monitoring**: $4/month - Real-time analytics
- **Performance Optimization**: $3/month - Speed enhancements

### 4. Physical Products
- **DOTM Metal Card**: $99.99 - Premium collectible
- **Hardware Accessories**: Various pricing
- **Limited Editions**: Exclusive items for members

### 5. Token Services
- **DOTM Rewards**: 10.33% cashback on purchases
- **New Member Bonus**: 10.33 tokens for joining
- **Founding Member Benefits**: Special perks and recognition
- **Staking Rewards**: Additional benefits for token holders

### 6. API Services
- **OXIO Integration**: eSIM provisioning and management
- **Stripe Processing**: Payment handling and subscriptions
- **Developer Tools**: SDKs and documentation
- **Webhook Support**: Real-time event notifications

### 7. Support Services
- **Standard Support**: Available to all users
- **Priority Support**: Enhanced assistance for members
- **Premium Support**: Dedicated support for full members
- **Community Forums**: Peer-to-peer assistance and discussions

## 🏗️ Technical Specifications

### API Specifications
- **Base URL**: `https://gorse.dotmobile.app`
- **MCP Endpoint**: `https://gorse.dotmobile.app/mcp/messages` (JSON-RPC 2.0)
- **MCP v1 Server**: `https://gorse.dotmobile.app/mcp` (Legacy)
- **Response Format**: JSON and HTML
- **Authentication**: Firebase Bearer tokens for user operations
- **Rate Limiting**: 100 eSIM activations/hour with queue management
- **Protocol**: Model Context Protocol (2024-11-05 specification)

### Database Schema
- **Users**: Firebase UID mapping and profile data
- **Subscriptions**: Stripe integration and billing cycles
- **Purchases**: Transaction history and product tracking
- **Beta Requests**: Approval workflow and phone assignments
- **Network Features**: User preferences and service configurations

### Blockchain Integration
- **Network**: Ethereum Mainnet
- **Token Standard**: ERC-20
- **Wallet Integration**: MetaMask and Web3 compatible
- **Transaction Tracking**: Complete on-chain activity monitoring

## 📈 Platform Statistics

- **Total Services**: 20+ across 7 categories
- **Global Coverage**: 190+ countries
- **API Uptime**: 99.9%
- **Active Integrations**: Firebase, Stripe, OXIO, Ethereum, MCP
- **AI Platforms**: ChatGPT Plus, Google Gemini
- **Token Contract**: Live on Ethereum Mainnet
- **Beta Users**: Growing community of early adopters
- **MCP Protocol**: 2.0 (2024-11-05 specification)
- **Rate Limit**: 100 eSIM activations/hour with intelligent queueing

## 🚀 Getting Started

### For Users (AI-Powered Activation) 🆕
1. **Open ChatGPT or Gemini**: Use your favorite AI assistant
2. **Say the Magic Words**: "I need a Global Data eSIM" or "Activate a DOT eSIM"
3. **Pay $1 Invoice**: Check your email and pay via Stripe link
4. **Get Your eSIM**: Receive QR code + phone number in <5 minutes
5. **Travel Globally**: Install eSIM and connect in 190+ countries

**No website navigation required. No account creation forms. Just conversation!**

### For Users (Traditional Method)
1. **Sign Up**: Create account at [gorse.dotmobile.app](https://gorse.dotmobile.app)
2. **Choose Plan**: Select Basic ($24/year) or Full ($66/year) membership
3. **Purchase Data**: Buy global data packages ($20 for 10GB)
4. **Request Beta**: Apply for beta access through your profile
5. **Earn Tokens**: Receive DOTM rewards for all activities

### For Developers
1. **Explore MCP**: Visit [gorse.dotmobile.app/mcp](https://gorse.dotmobile.app/mcp)
2. **Test AI Integration**: Try the activate_esim tool via JSON-RPC 2.0
3. **Read Documentation**: Complete API reference at [/mcp/docs](https://gorse.dotmobile.app/mcp/docs)
4. **Build Applications**: Integrate DOTM services into your apps
5. **Monitor Rate Limits**: Track usage and queue status in real-time
6. **Join Community**: Connect with other developers

### For Business Partners
1. **API Access**: Programmatic service integration
2. **White Label**: Custom branding options available
3. **Bulk Pricing**: Volume discounts for enterprise
4. **Custom Features**: Tailored solutions for specific needs
5. **Partnership Program**: Revenue sharing opportunities

## 📞 Support & Community

### Getting Help
- **Documentation**: Comprehensive guides and API reference
- **Community Forums**: Peer-to-peer assistance and discussions
- **Email Support**: Direct assistance for technical issues
- **Priority Support**: Enhanced assistance for members
- **Emergency Support**: 24/7 availability for critical issues

### Contributing
We welcome contributions to the DOTM Platform:

1. **Fork Repository**: Create your own copy for development
2. **Create Branch**: `git checkout -b feature/improvement`
3. **Make Changes**: Implement your enhancements
4. **Test Thoroughly**: Ensure all functionality works correctly
5. **Submit PR**: Include detailed description of changes

### Resources
- **API Documentation**: [gorse.dotmobile.app/mcp](https://gorse.dotmobile.app/mcp)
- **GitHub Repository**: Source code and issue tracking
- **Technical Blog**: Implementation details and updates
- **Community Discord**: Real-time discussions and support

## 📄 License

This project uses a dual licensing structure:

### Open Source Code (MIT License)
The software code is licensed under the **MIT License** - see the [LICENSE](https://github.com/dataontap/gorse/tree/HEAD/LICENSE) file for details. You are free to use, modify, and distribute the code according to MIT License terms.

### API Service Usage (Commercial Terms)
The hosted API services and infrastructure are subject to **commercial terms** - see [TERMS_OF_SERVICE.md](https://github.com/dataontap/gorse/blob/HEAD/TERMS_OF_SERVICE.md) for complete details.

**API Pricing (Subject to Change):**
- **Free Tier**: Up to 100 TPH (Transactions Per Hour) across all API endpoints
- **Paid Tier**: $1.00 USD per active user per month for usage exceeding 100 TPH
- **Network Access**: Charged separately per membership pricing (see Pricing Structure section)

For questions about licensing or API usage, contact: **rbm@dotmobile.app**

## 🔗 Quick Links

- **Main Platform**: [gorse.dotmobile.app](https://gorse.dotmobile.app)
- **MCP Server**: [mcp.dotmobile.app](https://mcp.dotmobile.app)
- **API Documentation**: [gorse.dotmobile.app/mcp](https://gorse.dotmobile.app/mcp)
- **JSON API**: [gorse.dotmobile.app/mcp/api](https://gorse.dotmobile.app/mcp/api)
- **DOTM Token**: [0xF57ab8DEE7ebE3686DB8Bf89E8aCc15E94B97A8D](https://etherscan.io/token/0xF57ab8DEE7ebE3686DB8Bf89E8aCc15E94B97A8D)

---

**Built with**: Flask, PostgreSQL, Firebase, Stripe, OXIO, Ethereum, and ❤️

*Connecting the world through decentralized telecommunications*

---

### 🌟 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=dotmobile/dotm-platform&type=Date)](https://star-history.com/#dotmobile/dotm-platform&Date)

### 📊 Platform Status

![Platform Status](https://img.shields.io/badge/Platform-Operational-green)
![API Status](https://img.shields.io/badge/API-99.9%25_Uptime-green)
![Token Status](https://img.shields.io/badge/DOTM_Token-Live_on_Mainnet-blue)
![Beta Program](https://img.shields.io/badge/Beta_Program-Active-orange)

**Last Updated**: October 22, 2025
**Version**: 3.1.1 - MCP AI Integration
**DOTM Token Contract**: 0xF57ab8DEE7ebE3686DB8Bf89E8aCc15E94B97A8D
**MCP Endpoint**: https://gorse.dotmobile.app/mcp/messages

### 🎯 What's New in v3.1.1

**AI-Driven eSIM Activation:**
- ✅ Model Context Protocol (MCP) integration
- ✅ ChatGPT and Gemini AI support
- ✅ Natural language eSIM activation
- ✅ Automatic user registration from AI conversations
- ✅ Automatic Stripe invoice generation ($1 eSIM beta)
- ✅ Rate limiting: 100 activations/hour with queue management
- ✅ Real-time ETA estimation for queued requests
- ✅ Comprehensive logging and monitoring
- ✅ Trigger phrases: "Global Data eSIM" and "DOT eSIM"

**Technical Improvements:**
- ✅ JSON-RPC 2.0 over HTTP + SSE transport
- ✅ Thread-safe rate limiter with rolling 60-minute window
- ✅ Enhanced security with Firebase authentication
- ✅ Payment verification via Stripe webhooks
- ✅ OXIO live activation integration
- ✅ Complete test coverage (ChatGPT, Gemini, end-to-end)

DOT Global Connectivity

🤖 AI Integration - NEW!

Activate eSIMs by simply talking to ChatGPT or Gemini AI

Users can now discover and activate DOTM eSIMs entirely through natural conversation:

👤 USER → ChatGPT: "I need a Global Data eSIM for my trip to Europe"

🤖 ChatGPT: "I can help you activate a DOTM eSIM! I've sent a $1 
            invoice to your email. After payment, you'll have instant 
            global connectivity."

✅ RESULT: eSIM activated, QR code delivered, ready to travel!

Trigger Phrases

"Global Data eSIM" - Discover DOT through ChatGPT
"DOT eSIM" - Activate via Gemini AI or ChatGPT

How It Works

Conversation-Based Discovery - No website needed
Automatic Account Creation - Seamless onboarding
Email-Based Payment - Simple $1 Stripe invoice
Instant Activation - eSIM ready in <5 minutes
QR Code Delivery - Install and connect immediately

Powered by Model Context Protocol (MCP) - Learn More

🌐 Full MVNO Framework

DOTM Platform is a next-generation telecommunications service combining global eSIM connectivity with blockchain rewards and AI-driven automation.

Code, APIs and App Available for FREE. $1/month license for globally connected active users. Ask for above 100TPH access.

What We Provide

✅ Global eSIM Connectivity - 190+ countries via OXIO network
✅ AI-Powered Activation - ChatGPT & Gemini integration
✅ Blockchain Rewards - DOTM token on Ethereum Mainnet
✅ Automated Invoicing - Stripe payment processing
✅ Enterprise Security - Rate limiting, Firebase auth, encryption
✅ Full MVNO - Complete telecommunications stack

We provide global eSIM connectivity, automation, network services intelligence and network optimization features through a unified ecosystem in a public cloud. Our data servers are located solely in North America: N.Virginia, USA and in Montreal, Canada. We use Full MVNO type of connectivity in the USA, Mexico and in Canada soon hopefully.

Technology Stack

Firebase authentication, Gemini for AI, NeonDB for Postgresql databases, Resend for email delivery, ElevenLabs for voice synthesis, Bitchat for fallback connectivity, Ethereum blockchain integration, and Model Context Protocol (MCP) for AI assistant integration. Full list of integrations below.

🚀 Live Platform

Main Platform: gorse.dotmobile.app
MCP Server: mcp.dotmobile.app
API Documentation: gorse.dotmobile.app/mcp

💎 DOTM Token (Ethereum Mainnet)

Contract Address: 0xF57ab8DEE7ebE3686DB8Bf89E8aCc15E94B97A8D

Token Economics

Token Symbol: DOTM
Network: Ethereum Mainnet
Max Supply: 10,333,333 DOTM
Current Supply: (mint-on-demand)
Decimals: 18

Reward System

10.33% Cashback: Earn DOTM tokens on all service purchases
Usage Rewards: Additional tokens based on service utilization
Founding Member Benefits: Special perks for early adopters

Smart Contract Features

ERC-20 Standard: Full compatibility with Ethereum ecosystem
Mintable: Owner-controlled token distribution
Reward Automation: Automatic distribution based on platform activity
Supply Cap: Fixed maximum supply with deflationary mechanics

🌍 Core Services

Global eSIM Connectivity

Global Data Package: $20.00 USD for 10GB
190+ Countries: Worldwide coverage through OXIO network
Instant Activation: Immediate service provisioning
No Roaming Fees: Transparent, fixed pricing

Membership Plans

Basic Membership: $24.00 USD/year
- Global data access
- Standard support
- DOTM token rewards
- Basic network features
Full Membership: $66.00 USD/year
- Unlimited talk & text
- Priority support
- Enhanced token rewards
- Premium network features
- Beta access priority

Beta Program

Email Approval Workflow: Admin-managed access control
Phone Number Assignment: Random North American numbers via OXIO
QR Code Generation: RESIN data and phone access codes
Profile Integration: Complete beta management in user profiles
OXIO Integration: Automatic user provisioning and GroupID management

🔧 Platform Architecture

Backend Infrastructure

Flask REST API: Core application with Flask-RESTX documentation
PostgreSQL Database: Connection pooling and data management
Firebase Authentication: Secure user identity management
Stripe Integration: Complete payment processing infrastructure
OXIO API: Global eSIM and connectivity services
Ethereum Integration: Web3.py for blockchain interactions
Resend Email API: Professional email delivery with 99.9% deliverability

Key Integrations

Firebase Admin SDK: Server-side authentication and user management
Stripe Payments: Subscription management and billing
Network Services API: eSIM provisioning and connectivity management
Ethereum Mainnet: DOTM token rewards and transactions
Resend Email API: Professional email delivery and notifications
ElevenLabs: Voice synthesis for personalized interactions
OpenAI API: AI-powered customer support

🎙️ Advanced Communication Features

Resend Email Service Integration

Professional Email Delivery: High-deliverability email service with 99.9% uptime
Verified Domain: emails sent from @dotmobile.app with proper SPF/DKIM authentication
Transactional Emails: Magic link authentication, welcome messages, and notifications
Template Support: HTML email templates with dynamic content injection
Delivery Analytics: Real-time email delivery tracking and bounce management
API Integration: RESTful email API with automatic failover to SMTP backup
Scalable Infrastructure: Handle high-volume email campaigns and notifications

ElevenLabs.io Voice Synthesis

Multilingual Support: Welcome messages in English, Spanish, and French
Personalized Messages: Dynamic user-specific welcome audio content
Premium Voices: High-quality neural voice synthesis (default: Rachel voice)
Custom Voice Settings: Adjustable stability, similarity boost, and style parameters
Real-time Generation: On-demand text-to-speech conversion for user interactions
Integration: Seamless voice messages for onboarding and notifications

Bitchat Encrypted Messaging

Zero Registration: No accounts, emails, or phone numbers required
Military-Grade Encryption: X25519 key exchange, AES-256-GCM, Ed25519 signatures
Mesh Networking: Bluetooth LE peer-to-peer communication with store-and-forward capability
Privacy First: Ephemeral messages, emergency triple-tap data wipe
Battery Optimized: Adaptive power modes with intelligent message compression (LZ4)
Offline Operation: Complete functionality without internet or cellular connectivity
Cover Traffic: Timing obfuscation and dummy messages to prevent traffic analysis

Model Context Protocol (MCP) Server 🆕

Revolutionary AI-Driven eSIM Activation

The DOTM Platform features a production-ready MCP server that enables ChatGPT and Gemini AI to activate eSIMs through natural conversation.

Key Features

✅ JSON-RPC 2.0 Protocol: Latest MCP specification (2024-11-05)
✅ 5 AI Tools Available: Calculate pricing, search services, compare plans, activate eSIMs
✅ Automatic User Registration: New users created seamlessly from AI conversations
✅ Automatic Invoice Generation: Stripe invoices sent when payment needed ($1 for eSIM beta)
✅ Rate Limiting: 100 activations/hour with intelligent queue management
✅ Real-Time ETA: Queue position and wait time estimation
✅ Privacy-First Design: Zero user data exposure to AI assistants
✅ OXIO Integration: Live eSIM provisioning and phone number assignment

Conversation Flow

1. User: "I want a Global Data eSIM" 
   ↓
2. AI calls MCP server → Checks authentication
   ↓
3. Server creates account (if new user)
   ↓
4. Server checks payment → Sends $1 Stripe invoice
   ↓
5. User pays invoice via email
   ↓
6. User: "I paid the invoice"
   ↓
7. AI calls MCP server → Payment verified
   ↓
8. Server activates eSIM via OXIO
   ↓
9. QR code + phone number sent to user's email
   ↓
10. User installs eSIM and travels globally!

Security & Performance

Rate Limit: 100 activations per hour (configurable)
Queue Management: Position tracking with accurate ETAs
Firebase Auth: Enterprise-grade user authentication
Stripe Payment: Automatic invoice generation and verification
Comprehensive Logging: Full audit trail for debugging and monitoring

Unified MCP Endpoints

Info: GET /mcp - Server capabilities and version
Messages: POST /mcp/messages - JSON-RPC 2.0 tool execution
Docs: GET /mcp/docs - Interactive documentation

Available AI Tools

calculate_pricing - Dynamic cost calculations for service bundles
search_services - Discover available telecommunications services
get_service_details - Detailed information about specific services
compare_memberships - Side-by-side plan comparisons
activate_esim - Complete eSIM activation with payment verification ⭐

Testing

Comprehensive test suites validate the entire AI integration:

✅ Invocation phrase tests ("Global Data eSIM", "DOT eSIM")
✅ ChatGPT integration tests (6 test cases)
✅ Gemini AI integration tests (7 test cases)
✅ End-to-end activation workflow
✅ Rate limiting and queue management
✅ Payment verification and invoice generation

📱 Beta Approval System

User Flow

Request Access: Users submit beta requests through their Profile page
Admin Notification: Automated email with approve/reject links
OXIO Integration: Phone number assignment and user provisioning
QR Code Generation: Service activation codes and RESIN data
Profile Display: Phone numbers and service details in user interface

Technical Features

Email Workflow: HTML notifications with one-click approval
Random Phone Generation: North American area codes and numbers
GroupID Management: Unique service identifiers for organization
Database Tracking: Complete request history and status management
API Endpoints: RESTful interfaces for beta management

API Endpoints

POST /api/beta-request - Submit beta access request
GET /api/beta-approve/<id> - Admin approval endpoint
GET /api/beta-reject/<id> - Admin rejection endpoint
GET /api/beta-status - Check user beta status
GET /api/user-phone-numbers - Retrieve phone numbers with QR codes

💰 Pricing Structure

Service	Price	Billing	Features
Global Data	$20.00 USD	Per 10GB	Worldwide coverage, instant activation
Basic Membership	$24.00 USD	Annual	Global access, standard support, token rewards
Full Membership	$66.00 USD	Annual	Unlimited features, priority support, enhanced rewards
Network Security	$5.00 USD	Monthly	VPN access, threat protection
VPN Access	$8.00 USD	Monthly	Global server network, unlimited bandwidth
Priority Routing	$6.00 USD	Monthly	Optimized network paths
DOTM Metal Card	$99.99 USD	One-time	Physical collectible, founding member status

Cost Calculator

Free Tier: $0/month (Beta access only)
Basic Plan: ~$2/month (Basic membership)
Premium Plan: ~$5.50/month (Full membership)
Maximum Configuration: ~$30-40/month (All features enabled)

API Access Pricing (Subject to Change)

For developers integrating with the DOTM Platform API:

Tier	TPH Limit	Price	Billing	Notes
Free	≤100 TPH	$0	N/A	All API endpoints included
Paid	>100 TPH	$1.00 USD	Per active user/month	Billed in arrears

TPH = Transactions Per Hour (total API requests across all endpoints)

Important Notes:

Network access (eSIM, data packages) charged separately per service pricing above
See TERMS_OF_SERVICE.md for complete API terms
Pricing subject to change with 30 days notice
Contact rbm@dotmobile.app for enterprise pricing

🛡️ Security & Privacy

Privacy Protection

Zero User Data Exposure: MCP server only exposes public service information
Data Isolation: Strict separation between user data and public APIs
Compliant Error Handling: Generic responses without system internals
Regular Audits: Quarterly compliance and security reviews

Security Features

HTTPS/TLS Encryption: All communications encrypted end-to-end
Firebase Authentication: Industry-standard identity management
Rate Limiting: API abuse protection and traffic management
Input Validation: Comprehensive parameter sanitization
Audit Logging: Complete action tracking and compliance records

🤖 AI Assistant Integration (MCP)

Activate eSIMs via ChatGPT or Gemini

Your users can now activate eSIMs by simply talking to their favorite AI assistant:

Example Conversation:

👤 USER: "I'm traveling to Japan next week and need mobile data. 
         I heard about Global Data eSIM - can you help?"

🤖 ChatGPT: "I can definitely help you get a DOTM Global Data eSIM 
            for your trip to Japan! Let me set that up for you..."
            
            [Calls DOTM MCP Server]

💾 DOTM: Creates account + Sends $1 Stripe invoice to user@email.com

🤖 ChatGPT: "I've created your DOTM account and sent a $1 invoice to 
            your email. Once you pay it, I'll activate your eSIM with 
            a phone number and data access for Japan!"

📧 USER: [Receives email, pays $1 via Stripe]

👤 USER: "I paid the invoice!"

🤖 ChatGPT: [Calls DOTM MCP Server again]

💾 DOTM: Payment verified ✓ → Activates eSIM → Assigns +1-555-123-4567

🤖 ChatGPT: "Perfect! Your DOTM eSIM is now active! 
            📱 Phone Number: +1-555-123-4567
            📧 Check your email for the QR code to install the eSIM
            🌏 You'll have data coverage throughout Japan
            
            Have an amazing trip!"

✅ USER: Scans QR code, installs eSIM, lands in Japan with connectivity!

MCP Integration for Developers

Test the MCP Server:

# Check server status and capabilities
curl https://gorse.dotmobile.app/mcp

# Call the activate_esim tool via JSON-RPC 2.0
curl -X POST https://gorse.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"
      }
    }
  }'

# Response: Invoice sent or eSIM activated (depending on payment status)

Rate Limit Monitoring:

# Get current rate limit statistics
curl https://gorse.dotmobile.app/mcp | jq

# Example response shows:
# - Current activations: 87/100
# - Available slots: 13
# - Capacity used: 87.0%
# - Queue status: Empty

JSON-RPC API Integration

Note: The API now uses JSON-RPC 2.0 protocol. Legacy REST endpoints have been removed.

Python Integration

import requests

BASE_URL = "https://gorse.dotmobile.app/mcp/messages"

# Fetch service catalog using JSON-RPC
response = requests.post(BASE_URL, json={
    "jsonrpc": "2.0",
    "id": 1,
    "method": "resources/read",
    "params": {"uri": "dotm://services/catalog"}
})
services = response.json()["result"]["contents"][0]["text"]

# Calculate pricing using tools
pricing_response = requests.post(BASE_URL, json={
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "calculate_pricing",
        "arguments": {
            "service_ids": ["basic_membership", "network_security_basic"]
        }
    }
})

result = pricing_response.json()["result"]["content"][0]["text"]
print(result)

JavaScript Integration

const BASE_URL = 'https://gorse.dotmobile.app/mcp/messages';

async function callMCP(method, params = {}) {
  const response = await fetch(BASE_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: Math.floor(Math.random() * 1000),
      method,
      params
    })
  });
  return response.json();
}

// Fetch service catalog
const catalog = await callMCP('resources/read', {
  uri: 'dotm://services/catalog'
});
console.log('Services:', catalog.result.contents[0].text);

// Calculate pricing
const pricing = await callMCP('tools/call', {
  name: 'calculate_pricing',
  arguments: { service_ids: ['full_membership', 'network_vpn_access'] }
});
console.log('Pricing:', pricing.result.content[0].text);

📊 Service Categories

1. Connectivity Services

Global eSIM: Worldwide mobile data access
Data Packages: 10GB packages at $20 USD
Beta Programs: Early access to new features
Network Coverage: 190+ countries supported

2. Membership Plans

Basic: $24/year - Essential connectivity features
Full: $66/year - Premium features and unlimited access
Beta: Free - Early access and testing privileges

3. Network Features (Monthly Add-ons)

Network Security: $5/month - Advanced threat protection
VPN Access: $8/month - Global server network
Priority Routing: $6/month - Optimized network paths
Network Monitoring: $4/month - Real-time analytics
Performance Optimization: $3/month - Speed enhancements

4. Physical Products

DOTM Metal Card: $99.99 - Premium collectible
Hardware Accessories: Various pricing
Limited Editions: Exclusive items for members

5. Token Services

DOTM Rewards: 10.33% cashback on purchases
New Member Bonus: 10.33 tokens for joining
Founding Member Benefits: Special perks and recognition
Staking Rewards: Additional benefits for token holders

6. API Services

OXIO Integration: eSIM provisioning and management
Stripe Processing: Payment handling and subscriptions
Developer Tools: SDKs and documentation
Webhook Support: Real-time event notifications

7. Support Services

Standard Support: Available to all users
Priority Support: Enhanced assistance for members
Premium Support: Dedicated support for full members
Community Forums: Peer-to-peer assistance and discussions

🏗️ Technical Specifications

API Specifications

Base URL: https://gorse.dotmobile.app
MCP Endpoint: https://gorse.dotmobile.app/mcp/messages (JSON-RPC 2.0)
MCP v1 Server: https://gorse.dotmobile.app/mcp (Legacy)
Response Format: JSON and HTML
Authentication: Firebase Bearer tokens for user operations
Rate Limiting: 100 eSIM activations/hour with queue management
Protocol: Model Context Protocol (2024-11-05 specification)

Database Schema

Users: Firebase UID mapping and profile data
Subscriptions: Stripe integration and billing cycles
Purchases: Transaction history and product tracking
Beta Requests: Approval workflow and phone assignments
Network Features: User preferences and service configurations

Blockchain Integration

Network: Ethereum Mainnet
Token Standard: ERC-20
Wallet Integration: MetaMask and Web3 compatible
Transaction Tracking: Complete on-chain activity monitoring

📈 Platform Statistics

Total Services: 20+ across 7 categories
Global Coverage: 190+ countries
API Uptime: 99.9%
Active Integrations: Firebase, Stripe, OXIO, Ethereum, MCP
AI Platforms: ChatGPT Plus, Google Gemini
Token Contract: Live on Ethereum Mainnet
Beta Users: Growing community of early adopters
MCP Protocol: 2.0 (2024-11-05 specification)
Rate Limit: 100 eSIM activations/hour with intelligent queueing

🚀 Getting Started

For Users (AI-Powered Activation) 🆕

Open ChatGPT or Gemini: Use your favorite AI assistant
Say the Magic Words: "I need a Global Data eSIM" or "Activate a DOT eSIM"
Pay $1 Invoice: Check your email and pay via Stripe link
Get Your eSIM: Receive QR code + phone number in <5 minutes
Travel Globally: Install eSIM and connect in 190+ countries

No website navigation required. No account creation forms. Just conversation!

For Users (Traditional Method)

Sign Up: Create account at gorse.dotmobile.app
Choose Plan: Select Basic ($24/year) or Full ($66/year) membership
Purchase Data: Buy global data packages ($20 for 10GB)
Request Beta: Apply for beta access through your profile
Earn Tokens: Receive DOTM rewards for all activities

For Developers

Explore MCP: Visit gorse.dotmobile.app/mcp
Test AI Integration: Try the activate_esim tool via JSON-RPC 2.0
Read Documentation: Complete API reference at /mcp/docs
Build Applications: Integrate DOTM services into your apps
Monitor Rate Limits: Track usage and queue status in real-time
Join Community: Connect with other developers

For Business Partners

API Access: Programmatic service integration
White Label: Custom branding options available
Bulk Pricing: Volume discounts for enterprise
Custom Features: Tailored solutions for specific needs
Partnership Program: Revenue sharing opportunities

📞 Support & Community

Getting Help

Documentation: Comprehensive guides and API reference
Community Forums: Peer-to-peer assistance and discussions
Email Support: Direct assistance for technical issues
Priority Support: Enhanced assistance for members
Emergency Support: 24/7 availability for critical issues

Contributing

We welcome contributions to the DOTM Platform:

Fork Repository: Create your own copy for development
Create Branch: git checkout -b feature/improvement
Make Changes: Implement your enhancements
Test Thoroughly: Ensure all functionality works correctly
Submit PR: Include detailed description of changes

Resources

API Documentation: gorse.dotmobile.app/mcp
GitHub Repository: Source code and issue tracking
Technical Blog: Implementation details and updates
Community Discord: Real-time discussions and support

📄 License

This project uses a dual licensing structure:

Open Source Code (MIT License)

The software code is licensed under the MIT License - see the LICENSE file for details. You are free to use, modify, and distribute the code according to MIT License terms.

API Service Usage (Commercial Terms)

The hosted API services and infrastructure are subject to commercial terms - see TERMS_OF_SERVICE.md for complete details.

API Pricing (Subject to Change):

Free Tier: Up to 100 TPH (Transactions Per Hour) across all API endpoints
Paid Tier: $1.00 USD per active user per month for usage exceeding 100 TPH
Network Access: Charged separately per membership pricing (see Pricing Structure section)

For questions about licensing or API usage, contact: rbm@dotmobile.app

🔗 Quick Links

Main Platform: gorse.dotmobile.app
MCP Server: mcp.dotmobile.app
API Documentation: gorse.dotmobile.app/mcp
JSON API: gorse.dotmobile.app/mcp/api
DOTM Token: 0xF57ab8DEE7ebE3686DB8Bf89E8aCc15E94B97A8D

Built with: Flask, PostgreSQL, Firebase, Stripe, OXIO, Ethereum, and ❤️

Connecting the world through decentralized telecommunications

🌟 Star History

📊 Platform Status

Last Updated: October 22, 2025 Version: 3.1.1 - MCP AI Integration DOTM Token Contract: 0xF57ab8DEE7ebE3686DB8Bf89E8aCc15E94B97A8D MCP Endpoint: https://gorse.dotmobile.app/mcp/messages

🎯 What's New in v3.1.1

AI-Driven eSIM Activation:

✅ Model Context Protocol (MCP) integration
✅ ChatGPT and Gemini AI support
✅ Natural language eSIM activation
✅ Automatic user registration from AI conversations
✅ Automatic Stripe invoice generation ($1 eSIM beta)
✅ Rate limiting: 100 activations/hour with queue management
✅ Real-time ETA estimation for queued requests
✅ Comprehensive logging and monitoring
✅ Trigger phrases: "Global Data eSIM" and "DOT eSIM"

Technical Improvements:

✅ JSON-RPC 2.0 over HTTP + SSE transport
✅ Thread-safe rate limiter with rolling 60-minute window
✅ Enhanced security with Firebase authentication
✅ Payment verification via Stripe webhooks
✅ OXIO live activation integration
✅ Complete test coverage (ChatGPT, Gemini, end-to-end)