Ethio Viral MCP Server

Lets Claude (Claude Code, Claude Desktop, or any MCP client) work with your Ethio Viral account through the public V2 API: check balance, search SMM services, place and track orders, and use the digital store.

Setup

1. Create an API key at https://ethio-viral.com/api-keys.

2. Install dependencies:

   cd mcp-server && npm install

Add to Claude Code

claude mcp add ethio-viral \
  --env ETHIO_VIRAL_API_KEY=YOUR_KEY \
  -- node /path/to/full-web-and-bot/mcp-server/index.js

Add to Claude Desktop

In claude_desktop_config.json:

{
  "mcpServers": {
    "ethio-viral": {
      "command": "node",
      "args": ["/path/to/full-web-and-bot/mcp-server/index.js"],
      "env": { "ETHIO_VIRAL_API_KEY": "YOUR_KEY" }
    }
  }
}

Tools

| Tool | What it does | Spends money | |------|--------------|--------------| | get_balance | Account balance | no | | list_services | Search SMM catalog (filtered, capped) | no | | place_order | Place an SMM order | yes | | get_order_status | Status of one or more orders | no | | cancel_order | Request cancellation | no | | request_refill | Request a refill | no | | list_store_products | Search gift cards / top-ups / eSIMs | no | | get_store_product | Product details + denominations | no | | purchase_store_product | Buy a store product | yes | | list_store_orders | Store order history | no | | get_store_order | One store order's details | no |

The two money-spending tools say so in their descriptions, so a well-behaved client will confirm with you before calling them.

Configuration

| Env var | Required | Default | |---------|----------|---------| | ETHIO_VIRAL_API_KEY | yes | — | | ETHIO_VIRAL_API_BASE | no | https://ethio-viral.com/api/v2 |

Rate limits come from the API itself: 60 requests/minute, 10,000/day per key.