Tenjin MCP Server
by BackTrackCo
README.md
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./assets/logo-dark.svg">
<img src="./assets/logo-light.svg" alt="Tenjin" width="220">
</picture>
</p>
<h3 align="center">The tool router for coding agents.</h3>
<p align="center">
<a href="https://www.npmjs.com/package/tenjin-cli"><img src="https://img.shields.io/npm/v/tenjin-cli?color=C85A3B&label=npm" alt="npm version"></a>
<a href="https://github.com/BackTrackCo/tenjin-agent/actions/workflows/ci.yml"><img src="https://github.com/BackTrackCo/tenjin-agent/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
<img src="https://img.shields.io/badge/works%20with-Claude%20Code-1C1A17" alt="Works with Claude Code">
<img src="https://img.shields.io/badge/Codex-experimental-1C1A17" alt="Codex experimental">
<a href="https://www.x402.org"><img src="https://img.shields.io/badge/payments-x402-8C9A7E" alt="Payments via x402"></a>
</p>
Tenjin suggests tools when they can help your agent, and one local wallet pays per call. Your agent can also browse the catalog and choose a tool directly. This repository contains the CLI and Claude Code/Codex integrations. For the product overview and getting started, visit [tenjin.sh](https://tenjin.sh).
<p align="center">
<a href="#why">Why</a> ·
<a href="#install">Install</a> ·
<a href="#try-it">Try it</a> ·
<a href="#what-your-agent-can-do">Tools</a> ·
<a href="#wallet-and-limits">Wallet</a> ·
<a href="#development">Development</a>
</p>
<p align="center">
<img src="./assets/demo.gif" alt="Tenjin in Claude Code: research, live crypto prices, company lookup, email verification, and computation" width="720">
</p>
## Why
Giving your coding agent good tools is a chore:
- **A key for every tool.** Sign up, pick a plan, paste an API key. Five tools, five accounts.
- **MCP servers crowd the context.** Each one loads its tool list into every session, needed or not.
- **Your agent forgets anyway.** It reaches for plain web search, so you write rules, and it still slips.
- **Some tools you need once.** A one-off lookup isn't worth the setup.
With Tenjin, install once and keep working. The router suggests tools when they help; the agent can also look for a tool itself. One wallet replaces separate provider accounts and keys for the tools in the catalog.
## Install
### Ask your agent
Paste this into Claude Code or Codex:
```text
Install Tenjin from tenjin.sh
```
### Install it yourself
**macOS / Linux** — no Node.js or npm required:
```sh
curl -fsSL https://tenjin.sh/install.sh | sh
```
**Windows** — run in PowerShell:
```powershell
irm https://tenjin.sh/install.ps1 | iex
```
**npm** — on any platform:
```sh
npm install -g tenjin-cli
tenjin install
```
Setup asks about spending limits and, on a fresh install, whether to turn on DeepSeek subagents. It then offers to add $5 so you can start using tools. **Add $5** opens checkout in your browser, and Tenjin carries on as soon as the money lands. With **Not now**, your agent asks when a task first needs a paid tool. Follow the activation step.
DeepSeek subagents are off by default. Turn them on during setup or with `tenjin config subagents on`, and Tenjin can offer DeepSeek V4.1 Flash for eligible Claude Code subagent jobs; Claude accepts or declines each one. A job costs up to your per-call limit ($1 by default), within your daily budget. Existing users keep their settings. Turn them off with `tenjin config subagents off`. [Sharing, charges and controls →](./docs/subagents.md)
Claude Code is supported; Codex is experimental. [Supported systems, setup and permissions →](./docs/agent-permissions.md)
## Try it
Once funded and activated, choose one prompt to try:
**Look up a company**
```text
Use Tenjin to find the company profile for stripe.com.
```
**Generate an image**
```text
Use Tenjin to generate a hero image of plum blossoms in ukiyo-e style.
```
**Make a voiceover**
```text
Use Tenjin to make a 10-second welcome voiceover for my app.
```
## What your agent can do
| Your agent needs | Provider examples | Provider price |
| --------------------------------- | ------------------------------- | -------------- |
| Library docs | Context7 | free |
| Web search and page reads | Exa, Firecrawl | 0.1¢ to 1.5¢ |
| Math and live crypto prices | Wolfram Alpha, CoinMarketCap | 1¢ to 2¢ |
| People, companies and emails | Apollo, Hunter, CompanyEnrich | 0.8¢ to 5¢ |
| X and Reddit | glim | 0.1¢ to 1¢ |
| Images | GPT Image, Nano Banana, Recraft | 3.5¢ to 14.4¢ |
| Voiceovers, sound effects, music | ElevenLabs, Google Lyria | 1¢ to 12¢ |
| Video clips | MiniMax Hailuo | 15.5¢ to 84¢ |
| Papers and SEC filings | arXiv, PubMed, SEC EDGAR | 0.3¢ to 4¢ |
| Instagram, TikTok and Google Maps | Scrape Creators, Google Maps | 2¢ |
| PDFs, screenshots and hosting | Cloudflare and others | 0.2¢ to 50¢ |
Example provider prices vary by tool and inputs and exclude Tenjin's routing fee. The quote for your call applies; [the full catalog has every tool and its current price →](https://tenjin.sh/tools)
Browsing and inspection are free. A selected tool pays only its provider; selected Context7 docs need no wallet or routing fee.
## Wallet and limits
| Automatic spending | Default |
| -------------------------------- | ------- |
| Daily budget shared across chats | $5 |
| Per-call limit | $1.00 |
A new chat does not reset the daily budget. Set any non-negative per-call USD limit with up to 6 decimal places; `0` blocks positive automatic payments. Routing fees vary by answer. Tool charges are separate. [Limits and approval →](./docs/agent-permissions.md#what-bounds-a-payment)
## Commands
| Command | What it does |
| ------------------------- | ------------------------------------------------- |
| `tenjin fund 5` | Add $5 in your browser, and watch it land |
| `tenjin balance` | Your balance and limits |
| `tenjin status` | On or paused, balance, accounts and settings |
| `tenjin usage` | What lookups cost, by day |
| `tenjin config` | Your rules: block, prefer or limit tools |
| `tenjin config names exa` | Every name a rule can use, such as Exa |
| `tenjin connect apify` | Use your own Apify, fal, Firecrawl or Exa account |
| `tenjin disconnect apify` | Forget a connected account here |
| `tenjin doctor` | Check setup and payment readiness |
| `tenjin update` | Update Tenjin |
| `tenjin uninstall` | Remove Tenjin from your agent; your balance stays |
`tenjin fund --usdc` shows the address to send USDC to from a crypto wallet instead. `tenjin wallet fund` and `tenjin wallet balance` still work. Have a code? Run `tenjin fund` and enter it under **Have a code?** on the page.
Calls on your own account bill its plan, not your Tenjin balance. [Your own accounts →](./docs/agent-permissions.md#your-own-accounts)
## Privacy and help
Routing sends relevant task context to Tenjin, with known secrets masked. Tool-result bodies are excluded. The wallet key stays local, also for a DeepSeek worker, which masks nothing else it reads and forwards to Tenjin and DeepSeek; only its job's tokens and your wallet key and passphrase are removed. [What is sent and retained →](./docs/agent-permissions.md#what-the-hooks-send)
- [Setup and permissions](./docs/agent-permissions.md): installation, activation, spending and sharing.
- [Troubleshooting](./docs/troubleshooting.md): a failed install, locked wallet or missing tool.
- [CLI/MCP reference](./docs/router-reference.md): request forms, payments and host details.
- [Safety model](./docs/safety-model.md): trust boundaries and remaining limitations.
- [Request a tool](https://github.com/BackTrackCo/tenjin-agent/issues/new?title=Tool%20request%3A%20&labels=enhancement) or [report a bug](https://github.com/BackTrackCo/tenjin-agent/issues).
## Development
See [CONTRIBUTING.md](./CONTRIBUTING.md) for the local build and targeted tests. [RELEASING.md](./RELEASING.md) covers exact-package checks, release acceptance and recurring QA.
Integrating another agent host? Start with the [request tool and host contracts](./docs/router-reference.md), then the server's [API reference](https://tenjin.sh/llms-full.txt).
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessUsually handled