Thunderbit MCP Server
Open-source toolkit for the Thunderbit Open API — CLI, MCP server, and Claude Code plugin.
This monorepo ships three packages, all backed by the Thunderbit Open API:
| Package | Purpose | Audience |
|---|---|---|
@thunderbit/thunderbit-cli | Command-line tool for distill / extract / batch | Developers, scripts, CI |
@thunderbit/mcp-server | Model Context Protocol server (7 tools) | AI assistants — Claude Desktop, Cursor, Cline, Claude Code |
thunderbit Claude Code plugin | Bundled MCP + 4 skills | Claude Code users |
Get a free API key at app.thunderbit.com/console/api-keys.
Quick Start
CLI
npm i -g @thunderbit/thunderbit-cli
export THUNDERBIT_API_KEY=tb_your_api_key_here
thunderbit distill https://example.com -f markdown
MCP Server (Claude Desktop / Cursor / Cline)
Edit your MCP client config:
{
"mcpServers": {
"thunderbit": {
"command": "npx",
"args": ["-y", "@thunderbit/mcp-server"],
"env": { "THUNDERBIT_API_KEY": "tb_your_api_key_here" }
}
}
}
Claude Code Plugin
claude plugin marketplace add thunderbit-com/thunderbit-mcp-server
claude plugin add thunderbit
export THUNDERBIT_API_KEY=tb_your_api_key_here
What you can do
- Convert any web page into clean, LLM-ready Markdown
- Extract structured data from pages using JSON Schema
- Get AI-suggested fields when you don't know what's on a page
- Run batch jobs on up to 100 URLs at a time
Pricing
Distill — 1 credit. Extract — 20 credits. Suggest fields — free. Batch jobs scale per URL. Status polling is free.
Top up at app.thunderbit.com/console/billing.
Development
git clone https://github.com/thunderbit-com/thunderbit-mcp-server.git
cd thunderbit-mcp-server
# each package is independent
cd packages/mcp-server && npm install
cd packages/cli && npm install
API Reference
The full HTTP contract is documented in openapi.yaml (OpenAPI 3.1) — base URL https://openapi.thunderbit.com, Bearer auth with your THUNDERBIT_API_KEY.
License
MIT © Thunderbit