About Averra Extract Mcp
Averra Extract MCP Server connects AI clients to Averra Extract, converting webpages into clean Markdown with metadata. It also provides tools for checking usage and managing API keys.
Key features
- 01Convert URLs to Markdown
- 02Include page metadata
- 03Check monthly usage quota
- 04Create and list API keys
- 05Revoke API keys
Use cases
- 01Preparing webpage content for AI pipelines
- 02Checking remaining monthly requests
- 03Managing account API keys
MCP support
It exposes five Averra Extract API operations as MCP tools, including URL conversion, quota checks, and API-key management. It supports stdio and HTTP transports.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
5Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | The webpage URL to extract content from. Accepts full URLs (`https://example.com`) or bare hostnames (`example.com` — auto-prefixed with `https://`). Max 2048 chars. Private/internal IPs are blocked by the API. |
| response_format | enum | No | Output format: 'markdown' for human-readable output (default), 'json' for machine-readable structured datamarkdown | json |
Details
From the project READMEAverra Extract MCP Server
MCP (Model Context Protocol) server for Averra Extract — lets AI agents like Claude, Cursor, and ChatGPT convert any webpage into clean, LLM-ready Markdown.
Listed in the official MCP registry 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 — 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
{
"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):
{
"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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.