Back to the catalog

Quackr

Virtual phone numbers for SMS verification, OTP receipt, and number management.

Open source Repository Open in the app JSON README (API)

About

Virtual phone numbers for SMS verification, OTP receipt, and number management.

Details

Kind
MCP servers
Topic
Communication
Publisher
io.quackr
Origin
official
Category
ferramentas
Transport
http
Version
1.0.3
Last push
2026-06-17T10:14:07Z
Repository state
ativo
Language
JavaScript
License
MIT
Added
2026-08-29 04:01:45
Updated
2026-08-29 04:01:45
Origin id
io.quackr/quackr

README

# Quackr MCP Server

[![npm version](https://img.shields.io/npm/v/quackr-mcp.svg)](https://www.npmjs.com/package/quackr-mcp)
[![npm downloads](https://img.shields.io/npm/dm/quackr-mcp.svg)](https://www.npmjs.com/package/quackr-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

Official MCP server for [Quackr](https://quackr.io) — virtual phone numbers for SMS verification and OTP receipt. Use Claude (or any MCP-compatible client) to check pricing and inventory, purchase temporary numbers, and read incoming SMS programmatically.

- **npm:** [`quackr-mcp`](https://www.npmjs.com/package/quackr-mcp) — `npx -y quackr-mcp`
- **Hosted endpoint:** `https://mcp.quackr.io/`
- **Transport:** Streamable HTTP
- **Auth:** `Authorization: Bearer YOUR_API_KEY` header

## Tools

| Tool | Description |
|---|---|
| `get-balance` | Get the current account balance in USD |
| `get-pricing` | Get phone number rental pricing for a specific country |
| `get-inventory` | Check available phone number inventory for a country |
| `purchase-number` | Purchase a temporary number for receiving SMS (deducts from balance) |
| `check-sms` | Check SMS messages received on a rented number |
| `list-active-numbers` | List all currently active (rented) numbers on the account |

## Getting an API Key

1. Sign in at [quackr.io](https://quackr.io)
2. Open your profile page
3. Copy the API key from the API section

## Install via npm

The [`quackr-mcp`](https://www.npmjs.com/package/quackr-mcp) package is a thin stdio
launcher that bridges any stdio MCP client to the hosted Quackr endpoint. It needs
Node.js 18+ — no separate install required, `npx` fetches it on first run.

```json
{
  "mcpServers": {
    "quackr": {
      "command": "npx",
      "args": ["-y", "quackr-mcp"],
      "env": {
        "QUACKR_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
```

You can also pass the key as a flag instead of an env var: `npx -y quackr-mcp --api-key YOUR_API_KEY_HERE`.

## Claude Code Setup

**Remote (recommended)** — connect directly to the hosted endpoint. Add to your
`~/.claude.json` (or a project `.mcp.json`):

```json
{
  "mcpServers": {
    "quackr": {
      "type": "http",
      "url": "https://mcp.quackr.io/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}
```

Or via the CLI:

```bash
claude mcp add --transport http quackr https://mcp.quackr.io/ --header "Authorization: Bearer YOUR_API_KEY_HERE"
```

## Claude Desktop Setup

Claude Desktop's JSON config only supports local (stdio) servers. Use the npm
launcher (see [Install via npm](#install-via-npm)) by adding the `npx quackr-mcp`
config above to `claude_desktop_config.json`, then restart Claude Desktop.

Alternatively, add Quackr as a remote connector: **Settings → Connectors → Add
custom connector**, enter `https://mcp.quackr.io/`, and add an `Authorization`
header with the value `Bearer YOUR_API_KEY`.

## Other MCP Clients

Any client supporting remote Streamable HTTP MCP servers with custom headers works. Point it at `https://mcp.quackr.io/` and pass your key via the `Authorization: Bearer YOUR_API_KEY` header.

## REST API

Quackr also exposes a full REST API at `https://api.quackr.io/` — see [`api.quackr.io/swagger.json`](https://api.quackr.io/swagger.json) for the full spec. Same `x-api-key` auth.

## Support

- Website: [quackr.io](https://quackr.io)
- Issues: file in this repo
- Email: support@quackr.io

## License

MIT — see [LICENSE](LICENSE).

More