# Thunderbit Mcp Server

> AI-powered web scraping and structured data extraction. CLI + MCP server + Claude Code plugin for the Thunderbit Open API.

- **Type:** MCP server
- **Install:** `agentstack add mcp-thunderbit-com-thunderbit-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [thunderbit-com](https://agentstack.voostack.com/s/thunderbit-com)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [thunderbit-com](https://github.com/thunderbit-com)
- **Source:** https://github.com/thunderbit-com/thunderbit-mcp-server
- **Website:** https://thunderbit.com/open-api

## Install

```sh
agentstack add mcp-thunderbit-com-thunderbit-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Thunderbit MCP Server

> Open-source toolkit for the Thunderbit Open API — CLI, MCP server, and Claude Code plugin.

[](https://npmjs.com/package/@thunderbit/mcp-server)
[](https://npmjs.com/package/@thunderbit/thunderbit-cli)
[](LICENSE)

This monorepo ships three packages, all backed by the [Thunderbit Open API](https://thunderbit.com/docs/introduction):

| Package | Purpose | Audience |
|---------|---------|----------|
| [`@thunderbit/thunderbit-cli`](packages/cli) | Command-line tool for distill / extract / batch | Developers, scripts, CI |
| [`@thunderbit/mcp-server`](packages/mcp-server) | Model Context Protocol server (7 tools) | AI assistants — Claude Desktop, Cursor, Cline, Claude Code |
| [`thunderbit` Claude Code plugin](packages/claude-plugin) | Bundled MCP + 4 skills | Claude Code users |

Get a free API key at [app.thunderbit.com/console/api-keys](https://app.thunderbit.com/console/api-keys).

---

## Quick Start

### CLI

```bash
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:

```json
{
  "mcpServers": {
    "thunderbit": {
      "command": "npx",
      "args": ["-y", "@thunderbit/mcp-server"],
      "env": { "THUNDERBIT_API_KEY": "tb_your_api_key_here" }
    }
  }
}
```

### Claude Code Plugin

```bash
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](https://app.thunderbit.com/console/billing).

---

## Development

```bash
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.yaml) (OpenAPI 3.1) — base URL `https://openapi.thunderbit.com`, Bearer auth with your `THUNDERBIT_API_KEY`.

---

## License

MIT © Thunderbit

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [thunderbit-com](https://github.com/thunderbit-com)
- **Source:** [thunderbit-com/thunderbit-mcp-server](https://github.com/thunderbit-com/thunderbit-mcp-server)
- **License:** MIT
- **Homepage:** https://thunderbit.com/open-api

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-thunderbit-com-thunderbit-mcp-server
- Seller: https://agentstack.voostack.com/s/thunderbit-com
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.