destinations-api

Destinations API Plugin for Claude Code

A comprehensive Claude Code plugin providing access to global telecommunications data including mobile country codes (MCC), mobile network codes (MNC), E.164/E.212 mapping, carrier information, and billing increments for 200+ countries and 1000+ operators.

Features

🔍 Slash Commands

• /destinations-api:destinations-search - Search telecom destinations by prefix, country, network, or MCC/MNC
• /destinations-api:billing-updates - Track billing increment changes and market trends
• /destinations-api:lookup-number - Identify carrier and billing info for specific phone numbers
• /destinations-api:compare-billing - Compare billing increments across countries and carriers

🤖 Specialized Agents

• Telecom Routing Advisor - Optimizes carrier routing based on cost and quality
• Billing Trend Analyst - Tracks billing changes and forecasts cost impacts
• Fraud Detection Helper - Validates numbers and detects suspicious patterns

⚡ Hooks

• API rate limit reminders (100 req/min)
• Response caching suggestions
• Phone number format validation

Installation

Quick Install (Recommended)

Add the GitHub marketplace and install the plugin:

# Add the marketplace from GitHub
/plugin marketplace add https://github.com/TelecomsXChangeAPi/destinations-api-claude-plugin.git

# Install the plugin
/plugin install destinations-api@destinations-api-marketplace

# Restart Claude Code to activate

The plugin will be immediately available with all slash commands and agents.

Updating the Plugin

To get the latest version:

# Update marketplace metadata
/plugin marketplace update destinations-api-marketplace

# Reinstall to get updates
/plugin uninstall destinations-api@destinations-api-marketplace
/plugin install destinations-api@destinations-api-marketplace

Local Development

For plugin development and testing:

# Clone the repository
git clone https://github.com/TelecomsXChangeAPi/destinations-api-claude-plugin.git
cd destinations-api-claude-plugin

# Create a development marketplace in parent directory
cd ..
mkdir dev-marketplace
cd dev-marketplace
mkdir .claude-plugin

# Create marketplace.json
cat > .claude-plugin/marketplace.json << 'EOF'
{
  "name": "dev-marketplace",
  "metadata": {
    "description": "Local development marketplace"
  },
  "owner": {"name": "Developer"},
  "plugins": [{
    "name": "destinations-api",
    "source": "../destinations-api-claude-plugin",
    "description": "Destinations API plugin (dev)"
  }]
}
EOF

# Start Claude Code from parent directory
cd ..
claude

# In Claude Code, add local marketplace
/plugin marketplace add ./dev-marketplace

# Install plugin
/plugin install destinations-api@dev-marketplace

# After making changes, reinstall:
/plugin uninstall destinations-api@dev-marketplace
/plugin install destinations-api@dev-marketplace

Usage Examples

Search for Destinations

# Search by country
/destinations-search Cambodia mobile networks

# Search by prefix
/destinations-search prefix +1212

# Search by MCC/MNC
/destinations-search mccmnc 45601

Example output:

┌───────────────────────────────────────────────────────────┐
│ Prefix  Country   Network          MCC/MNC  Billing      │
├───────────────────────────────────────────────────────────┤
│ 85510   CAMBODIA  Cellcard Mobile  45601    60/1  ★★★★  │
│ 85511   CAMBODIA  Smart Mobile     45606    60/60 ★★★   │
│ 85512   CAMBODIA  Metfone Mobile   45608    60/1  ★★★★  │
└───────────────────────────────────────────────────────────┘

Billing Legend:
• 60/1 = 60s minimum, then per-second (better)
• 60/60 = 60s minimum, then per-minute (standard)

Track Billing Updates

# Recent updates (last 30 days)
/billing-updates recent

# Updates for specific year
/billing-updates 2025

# Improvements only
/billing-updates 2025 improved

# Specific country
/billing-updates Cambodia 2025

Example output:

BILLING UPDATES: Last 30 Days

Improvements: 12 | Deteriorations: 3

Recent Changes:
• 2025-10-01: CAMBODIA Cellcard - 60/60 → 60/1 (★★★★ Better!)
• 2025-09-28: THAILAND AIS - 60/60 → 1/1 (★★★★★ Much better!)
• 2025-09-25: VIETNAM Viettel - 30/1 → 1/1 (★★★★ Better!)

Cost Impact: Estimated 15-25% savings on affected routes

Look Up Phone Numbers

# Lookup with international format
/lookup-number +855 12 345 6789

# Lookup with country code
/lookup-number 855123456789

# Lookup US number
/lookup-number +1-212-555-0100

Example output:

PHONE NUMBER ANALYSIS: +855 12 XXX XXXX

Country: CAMBODIA 🇰🇭
Prefix: 85512
Carrier: Metfone Mobile
Network Type: Mobile
MCC/MNC: 45608
Billing: 60/1 (60s minimum, then per-second)

Cost Estimate (per minute after minimum): $0.XX

Use Cases:
✓ Routing: Route via Metfone network
✓ Fraud Check: Valid Cambodia mobile number
✓ Cost Planning: Use 60/1 billing calculation