dev.averra/extract
URL-to-Markdown API for AI pipelines — clean markdown with metadata and caching.
Open source Open in the app JSON README (API)
About
URL-to-Markdown API for AI pipelines — clean markdown with metadata and caching.
Details
- Kind
- MCP servers
- Topic
- Files & documents
- Publisher
- dev.averra
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.5
- Last push
- 2026-04-11T17:10:14Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:01:29
- Updated
- 2026-08-29 03:01:29
- Origin id
dev.averra/extract
README
# Averra Extract MCP Server
MCP (Model Context Protocol) server for [Averra Extract](https://averra.dev) — lets AI agents like Claude, Cursor, and ChatGPT convert any webpage into clean, LLM-ready Markdown.
**Listed in the official [MCP registry](https://registry.modelcontextprotocol.io) as `dev.averra/extract`.** MCP clients that support registry-based install can reference that identifier directly; for clients that need manual configuration, see the install sections below.
## What it does
Exposes the Averra Extract API as 5 MCP tools:
| Tool | Description |
|---|---|
| `averra_extract_url` | Convert any URL to clean Markdown with metadata |
| `averra_check_usage` | Check monthly quota and remaining requests |
| `averra_create_api_key` | Create a new API key |
| `averra_list_api_keys` | List all API keys on the account |
| `averra_revoke_api_key` | Revoke an API key by ID |
## Get an API key
Sign up at [averra.dev](https://averra.dev) — the free plan includes 50 requests/month.
## Install (Claude Desktop)
Add this to your `claude_desktop_config.json`:
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"averra-extract": {
"command": "npx",
"args": ["-y", "@averra/extract-mcp"],
"env": {
"AVERRA_EXTRACT_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
Restart Claude Desktop. The 5 tools will appear in your session.
## Install (Cursor)
Add to `~/.cursor/mcp.json` (or use the Cursor MCP settings UI):
```json
{
"mcpServers": {
"averra-extract": {
"command": "npx",
"args": ["-y", "@averra/extract-mcp"],
"env": {
"AVERRA_EXTRACT_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
## Install (other MCP clients)
Any stdio-based MCP client works. Point it at `npx -y @averra/extract-mcp` with `AVERRA_EXTRACT_API_KEY` in the environment.
## Configuration
| Env var | Required | Default | Description |
|---|---|---|---|
| `AVERRA_EXTRACT_API_KEY` | yes | — | Your Extract API key (starts with `sk_live_`) |
| `AVERRA_EXTRACT_BASE_URL` | no | `https://averra.dev` | Override API host |
| `TRANSPORT` | no | `stdio` | `stdio` (local) or `http` (hosted) |
| `PORT` | no | `3000` | Port when `TRANSPORT=http` |
## Example prompts (Claude Desktop)
Once installed, try:
- "Extract the content from https://example.com and summarize it"
- "What's my remaining Extract quota this month?"
- "Read https://docs.anthropic.com/en/docs/intro and tell me the key concepts"
- "List my Extract API keys"
## License
MIT