# Numbers

> Numbers is a freemium MCP server for developer tools. Converts integers between bases 2-36, Roman numerals and English words for AI clients. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/numbers
- **Repository:** https://github.com/pipeworx-io/mcp-numbers
- **MCP Registry name:** io.github.pipeworx-io/numbers
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a thin number-utility pack on the Pipeworx gateway. Four tools cover base conversion between radixes 2 through 36, conversion of integers from 1 to 3999 to and from Roman numerals, and spelling an integer out in English words. The base conversion tool is described as keyless and offline, while the endpoint itself is reached over the network.

The server is exposed over streamable HTTP at a Pipeworx gateway URL and also as an npm stdio bridge. Without an API key, calls are anonymous and capped daily; a free Pipeworx account raises the cap. The gateway also lists shared meta-tools such as ask_pipeworx alongside the pack's own tools, which the README notes is intentional.

It suits developers who want deterministic numeral helpers available to an agent without writing their own parsing code.

## Features

- **Base conversion:** Converts an integer from one numeral base to another, covering bases 2 through 36.
- **Roman numeral encoding:** Turns integers from 1 to 3999 into Roman numeral strings.
- **Roman numeral parsing:** Reads a Roman numeral back into an integer and rejects malformed input.
- **English number words:** Spells out an integer in English words, such as hyphenated tens.
- **Remote and local connection:** Available as a streamable HTTP endpoint or an npm stdio bridge.
- **Optional API key:** Anonymous use is capped daily; a free key raises the daily limit.

## Good for

- Convert hexadecimal or binary values for an agent reasoning about data
- Generate Roman numerals for dates, chapter numbers or numbered titles
- Validate and parse Roman numerals found in user text
- Write numbers as words for invoices, checks or readable text output

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http numbers https://gateway.pipeworx.io/numbers/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/numbers/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "numbers": {
      "url": "https://gateway.pipeworx.io/numbers/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "numbers": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/numbers/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "numbers": {
      "serverUrl": "https://gateway.pipeworx.io/numbers/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "numbers": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/numbers/mcp"
    }
  }
}
```

## Tools

- `convert_base`: Convert an integer between numeral bases 2-36.
- `to_roman`: Convert an integer (1-3999) to Roman numerals.
- `from_roman`: Convert a Roman numeral to an integer.
- `number_to_words`: Spell an integer in English words.

## FAQ

### Does the base conversion tool need a network connection?

The README describes convert_base as keyless and offline, but the pack itself is served through the Pipeworx gateway, and the npm bridge states it needs network access.

### What range do the Roman numeral tools support?

to_roman converts integers from 1 to 3999. from_roman rejects malformed numerals.

### Is an API key required?

No. Calls without a key are anonymous and capped at 50 per day; a free account raises the cap to 200 per day.

### Which tools does the endpoint list?

Beyond the four pack tools, the endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx, according to the README.

### Is Numbers free?

Numbers has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Numbers to Claude Code?

Run this command in your terminal: claude mcp add --transport http numbers https://gateway.pipeworx.io/numbers/mcp

### What are the best alternatives to Numbers?

The closest alternatives to Numbers are Nato, Httpstatus, Currencyformat, Ulid and Unicode.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Nato](https://ai-powered.com/mcp/nato): Nato is a freemium MCP server for developer tools.
- [Httpstatus](https://ai-powered.com/mcp/httpstatus): Httpstatus is a freemium MCP server for developer tools.
- [Currencyformat](https://ai-powered.com/mcp/currencyformat): Currencyformat is a freemium MCP server for developer tools.
- [Ulid](https://ai-powered.com/mcp/ulid): Ulid is a freemium MCP server for developer tools.
- [Unicode](https://ai-powered.com/mcp/unicode): Unicode is a freemium MCP server for developer tools.
- [Htmlentities](https://ai-powered.com/mcp/htmlentities): Htmlentities is a freemium MCP server for developer tools.
- [Ipaddress](https://ai-powered.com/mcp/ipaddress): Ipaddress is a freemium MCP server for developer tools.
- [Url](https://ai-powered.com/mcp/url): Url is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/numbers
