Connect live services and ordering to your product.

Create a key from your account. The full key is shown once; keep it in a server-side environment variable, never browser code or a public repository.

Send the key as a Bearer token, or as key in form/JSON data. Bearer is recommended.

Authorization: Bearer smr_live_your_key
Content-Type: application/json

Returns listed services, our retail rate per 1,000, quantity limits and refill/cancel capabilities. Every public service ID is issued by SMM Route.

curl -X POST https://smmroute.com/api/v2 \
  -H "Authorization: Bearer $SMMROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"services"}'

Returns the current available USD balance. API and website orders use the same balance ledger.

{"action":"balance"}

→ {"balance":"25.40","currency":"USD"}

Create an order with a service returned by services, a public target URL and an allowed whole-number quantity. request_id is an optional UUID; reuse it on retries to prevent duplicate charges.

{
  "action": "add",
  "service": "svc_public_service_id",
  "link": "https://example.com/public-content",
  "quantity": 1000,
  "request_id": "65ac38db-ffb4-4fcc-95e8-6f85faec62ae"
}

→ {"order":"order_uuid"}

Use the order returned by SMM Route. Status can be Pending, In progress, Completed, Partial or Canceled. For Partial orders, the undelivered retail amount is returned automatically.

{"action":"status","order":"order_uuid"}

→ {
  "order": "order_uuid",
  "charge": "3.24",
  "status": "In progress",
  "remains": 420,
  "currency": "USD"
}

The CLI supports service filters, individual details, exact quotes, balance, ordering, status tracking, an interactive mode and JSON output. health needs no key; account operations use the same API key.

python -m pip install ./smmroute-cli.zip
smmroute configure --key "$SMMROUTE_API_KEY"
smmroute health
smmroute services --platform Instagram --family Followers
smmroute service show SERVICE_ID
smmroute service quote SERVICE_ID --quantity 2500
smmroute order create --service SERVICE_ID --link https://example.com/post --quantity 2500
smmroute --json order status ORDER_ID

The same package includes a local stdio MCP server for MCP-compatible agents to read live services, calculate exact prices, and check balance or order status. Order creation is blocked by default: the agent must preview first and explicitly send confirm=true.

{
  "mcpServers": {
    "smmroute": {
      "command": "smmroute-mcp",
      "env": { "SMMROUTE_API_KEY": "smr_live_your_key" }
    }
  }
}

HTTP 4xx identifies request, authentication, balance or quantity problems; HTTP 5xx means temporary unavailability. Error responses always include error and some include a stable code.