Thousand API — Claude Code MCP server: what it does, how to install
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.
no license 257 installs updated 2026-06-06
claude mcp add --transport http thousand-api https://thousand-api.run.toolsWhat Thousand API 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.
What it helps with
- 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 for the agent
- Add 5 business days to today, skipping Japanese holidays.
- How many tokens is this HTML? Run
text.estimate_tokensfirst. - Convert 250 EUR to JPY with
network.get_exchange_rate.
How to install Thousand API
Platform CLI: remote server
claude mcp add --transport http thousand-api https://thousand-api.run.toolsPlatform CLI: remote server
codex mcp add thousand-api --url https://thousand-api.run.toolsConfig file
{
"mcpServers": {
"thousand-api": {
"url": "https://thousand-api.run.tools"
}
}
}Config file
{
"servers": {
"thousand-api": {
"type": "http",
"url": "https://thousand-api.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http thousand-api https://thousand-api.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Thousand API
How do I install Thousand API in Claude Code?
One command registers the remote server: claude mcp add --transport http thousand-api https://thousand-api.run.tools.
What does Thousand API do?
It answers questions a model would otherwise guess at: holidays and working days, currency conversion, token counts and text chunks, QR codes, coordinates, page metadata. There are 84 tools, and some can be switched off.
Does it work outside Claude?
Yes. It is an HTTP MCP server, with setup snippets for Codex, Cursor, GitHub Copilot and Gemini CLI as well as Claude.