Skip to content

README.md

Latest commit

 

History

History
251 lines (167 loc) · 8.65 KB

README.md

File metadata and controls

251 lines (167 loc) · 8.65 KB

Documentation Index

Welcome to the Destinations API Claude Plugin documentation. This page serves as a central hub for all documentation resources.

Documentation Structure

User Documentation

For users who want to install and use the plugin:

Developer Documentation

For developers who want to understand the API or contribute:

Project Information

Quick Links by Use Case

Getting Started

  1. Install the plugin
  2. Try your first search
  3. Explore example workflows

Telecom Routing

Fraud Detection

Cost Management

API Integration

Plugin Development

Documentation by Component

Slash Commands

Each command is documented in both user and technical contexts:

Command User Guide Technical Details
/destinations-api:destinations-search README commands/destinations-search.md
/destinations-api:billing-updates README commands/billing-updates.md
/destinations-api:lookup-number README commands/lookup-number.md
/destinations-api:compare-billing README commands/compare-billing.md

Specialized Agents

Agent User Guide Technical Details
Telecom Routing Advisor README agents/telecom-routing-advisor.md
Billing Trend Analyst README agents/billing-trend-analyst.md
Fraud Detection Helper README agents/fraud-detection-helper.md

API Endpoints

Endpoint Purpose Documentation
GET /search/ Search destinations API Reference
GET /updates/ Historical billing updates API Reference
GET /updates/recent Recent billing changes API Reference
GET /updates/summary Update statistics API Reference

Understanding Key Concepts

Billing Increments

Billing increments are formatted as interval_1/interval_n:

Format Meaning Quality Documentation
1/1 Per-second from start ★★★★★ Best API Reference
60/1 60s min, then per-second ★★★★ Better README
60/60 Per-minute billing ★★ Standard Examples

MCC/MNC Codes

Mobile Country Code (MCC) + Mobile Network Code (MNC):

  • Format: Concatenated digits (e.g., 45601)
  • Example: 456 (Cambodia) + 01 (Cellcard) = 45601
  • Usage: Identify specific carrier networks
  • Documentation: API Reference - Data Formats

E.164 Format

International phone number standard:

  • Format: +[country code][subscriber number]
  • Example: +1 212 555 0100 (USA), +855 12 345 6789 (Cambodia)
  • Documentation: API Reference - Data Formats

Common Workflows

Workflow 1: Finding Best Route for a Destination

1. Search destination
   → /destinations-api:destinations-search [country] mobile

2. Compare billing
   → /destinations-api:compare-billing [options]

3. Get recommendation
   → Use telecom routing advisor agent

Detailed walkthrough

Workflow 2: Validating a Phone Number

1. Look up number
   → /destinations-api:lookup-number [phone]

2. Verify authenticity
   → Use fraud detection helper agent

3. Make decision
   → Allow, verify, or block based on analysis

Detailed walkthrough

Workflow 3: Monitoring Billing Changes

1. Check recent updates
   → /destinations-api:billing-updates recent

2. Analyze trends
   → Use billing trend analyst agent

3. Take action
   → Update routing, notify team, forecast costs

Detailed walkthrough

Troubleshooting

Common Issues

Issue Solution Documentation
Commands not appearing Restart Claude Code after install README - Troubleshooting
Rate limit errors Wait or increase pagination API Reference - Rate Limiting
No results found Check country name format (UPPERCASE) README - Troubleshooting
Installation errors Check marketplace path and format Contributing - Development Setup

Getting Help

API Information

  • Base URL: https://destinations-api.telecomsxchange.com
  • Rate Limit: 100 requests per minute
  • Authentication: None required (open access)
  • Coverage: 200+ countries, 1000+ operators

Complete API Reference

Contributing

We welcome contributions! Whether you're:

  • Fixing a bug
  • Adding a new command
  • Improving documentation
  • Suggesting features

Check out our Contributing Guide to get started.

Version Information

License

See LICENSE file for details.

Additional Resources

External Links

Standards & Specifications

  • E.164: ITU-T international phone number format
  • E.212: ITU-T mobile network identification
  • MCC/MNC: Mobile Country Code and Mobile Network Code standards

Need help navigating the docs? Start with the Main README for installation and basic usage, then explore specific topics using the links above.