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
