# Thousand API

Thousand API — a remote MCP server with 84 tools that compute instead of guess: holidays and working days, FX rates, token counts, QR codes, coordinates.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 257 installs
- Author: c-kouji
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/c-kouji/thousand-api
- Updated: 2026-06-06
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/thousand-api

## What it does

The server lives at `https://thousand-api.run.tools` and speaks HTTP. Its tools return answers computed from data: public holidays for a country and year, a date shifted by N working days with weekends skipped, cron and Laravel schedule parsing, timezone conversion with DST, a check whether a moment falls inside business hours.

Network tools cover currency conversion for a given amount, Japanese postal codes in both directions, page title and OGP tags for a URL, IP geolocation, distance between two coordinate pairs, and coordinate conversion between WGS84, Tokyo Datum, JGD2011 and map tiles. Text tools turn HTML into plain text, chunk long documents with overlap, mask PII, diff files and estimate token usage before a big file reaches the model.

Every call draws on an API key with a monthly plan, so `utility.get_usage` shows what is left before a 429 arrives. `utility.diagnose_mcp` checks API health and key validity without spending quota. `data.execute_batch` chains up to 10 tools in one call and passes earlier results through `{{stepId.field}}`; disabled tools stay out of `utility.search_tools` results.

## Requirements
- Remote server: `https://thousand-api.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http thousand-api https://thousand-api.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add thousand-api --url https://thousand-api.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "thousand-api": {
            "url": "https://thousand-api.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "thousand-api": {
            "type": "http",
            "url": "https://thousand-api.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http thousand-api https://thousand-api.run.tools
```

## When to use it
- shift a deadline by N working days around holidays
- estimate token cost before sending a long file to the model
- turn a link into a QR code image
- split a document into chunks without breaking sentences
- confirm the API key works and quota is left

## Example prompts
- Add 5 business days to today, skipping Japanese holidays.
- How many tokens is this HTML? Run `text.estimate_tokens` first.
- Convert 250 EUR to JPY with `network.get_exchange_rate`.

## Similar
- [CoreNexis API](https://affpapa.org/en/nevibecode/mcp/corenexis-api.md) — MCP server
- [date-calculation](https://affpapa.org/en/nevibecode/rules/date-calculation.md) — rule · ★ 880 repo stars
- [time-mcp](https://affpapa.org/en/nevibecode/mcp/time-mcp.md) — MCP server · ★ 72 repo stars
- [fixing-claude-export-conversations](https://affpapa.org/en/nevibecode/skills/fixing-claude-export-conversations.md) — skill · 825 installs
- [sample-text-processor](https://affpapa.org/en/nevibecode/skills/borghei-sample-text-processor.md) — skill · 118 installs
- [payqr](https://affpapa.org/en/nevibecode/mcp/payqr.md) — MCP server · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
