Averra Extract MCP
Averra Extract MCP 服务器
Averra Extract 的 MCP (Model Context Protocol) 服务器 — 让 Claude、Cursor 和 ChatGPT 等 AI 智能体能够将任何网页转换为整洁、适合 LLM 使用的 Markdown。
已在官方 MCP 注册表 中列为 dev.averra/extract。 支持基于注册表安装的 MCP 客户端可以直接引用该标识符;对于需要手动配置的客户端,请参阅下方的安装部分。
功能介绍
将 Averra Extract API 暴露为 5 个 MCP 工具:
工具 | 描述 |
| 将任何 URL 转换为带有元数据的整洁 Markdown |
| 检查每月配额和剩余请求数 |
| 创建新的 API 密钥 |
| 列出账户下的所有 API 密钥 |
| 按 ID 撤销 API 密钥 |
Related MCP server: mcp-server-scraper
获取 API 密钥
在 averra.dev 注册 — 免费套餐包含每月 50 次请求。
安装 (Claude Desktop)
将其添加到你的 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"
}
}
}
}重启 Claude Desktop。这 5 个工具将出现在你的会话中。
安装 (Cursor)
添加到 ~/.cursor/mcp.json(或使用 Cursor MCP 设置界面):
{
"mcpServers": {
"averra-extract": {
"command": "npx",
"args": ["-y", "@averra/extract-mcp"],
"env": {
"AVERRA_EXTRACT_API_KEY": "sk_live_your_key_here"
}
}
}
}安装 (其他 MCP 客户端)
任何基于 stdio 的 MCP 客户端均可使用。将其指向 npx -y @averra/extract-mcp 并在环境变量中设置 AVERRA_EXTRACT_API_KEY。
配置
环境变量 | 必需 | 默认值 | 描述 |
| 是 | — | 你的 Extract API 密钥(以 |
| 否 |
| 覆盖 API 主机地址 |
| 否 |
|
|
| 否 |
| 当 |
示例提示词 (Claude Desktop)
安装完成后,尝试:
"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"
许可证
MIT
Available Tools
5 toolsaverra_check_usageCheck Extract API UsageARead-onlyIdempotent
Check the current month's Extract API usage and remaining quota for the authenticated account.
Usage is counted per user across all API keys (not per key). Cached requests also count against the quota. The counter resets at the start of each calendar month (UTC).
Args:
response_format ('markdown' | 'json', optional): Output format. Default 'markdown'.
Returns: For JSON format: { "plan": "free" | "starter" | "pro" | "scale", "monthly_limit": number, // Max requests allowed this month "used": number, // Requests made so far this month "remaining": number // max(0, monthly_limit - used) }
For Markdown format: a summary showing plan, limit, used, and remaining.
Examples:
Use when: "How many extracts do I have left this month?"
Use when: Before a batch of extracts, to confirm sufficient quota.
Use when: User asks "Am I on the free plan?" — the plan field answers this.
Error Handling:
401: Invalid API key — check AVERRA_EXTRACT_API_KEY
Inputs: response_format.
averra_create_api_keyCreate Extract API KeyA
Create a new Extract API key for the authenticated account.
IMPORTANT: The plaintext key is returned ONLY ONCE in this response. It cannot be retrieved later — only the prefix is stored for display. If lost, the key must be revoked and a new one created.
The new key automatically inherits the plan and limits from your account's current subscription. You cannot choose a plan — it is determined by your billing state.
Args:
response_format ('markdown' | 'json', optional): Output format. Default 'markdown'.
Returns: For JSON format: { "key": string, // FULL plaintext key (shown once) — format: sk_live_<48 hex> "id": string, // Key ID for management operations "prefix": string, // First 12 chars (for display/reference) "plan": "free" | "starter" | "pro" | "scale", "monthly_limit": number, "created_at": string, // ISO 8601 "warning": string // Reminder to save the key }
Examples:
Use when: User wants to create a new API key for a different integration.
Use when: Rotating keys (create new, then revoke old).
Don't use without user confirmation — this creates a credential the user must save.
Error Handling:
401: Invalid API key — check AVERRA_EXTRACT_API_KEY
500: Database error — retry
Inputs: response_format.
averra_extract_urlExtract URL to MarkdownARead-onlyIdempotent
Convert any webpage URL into clean, LLM-ready Markdown using Averra Extract.
This tool fetches the page (executing JavaScript via a headless browser), strips navigation/ads/UI clutter via Mozilla Readability, converts the main content to Markdown, and returns it along with metadata (title, word count, links, language). Results are cached for 7 days and shared across users.
Use this when you need the actual content of a webpage for an LLM — e.g. reading a blog post, docs page, article, or product page to answer a question or synthesize information.
Args:
url (string, required): The webpage URL. Accepts
https://example.comor bareexample.com(https:// is auto-added). Max 2048 chars.response_format ('markdown' | 'json', optional): Output format. Default 'markdown'.
Returns: For JSON format, structured data: { "markdown": string, // Clean markdown content of the page "metadata": { "title": string, // Page title (from first H1 or URL fallback) "word_count": number, // Word count of extracted text "links": string[], // Unique URLs found in the content "language": string, // "en" or "unknown" "timestamp": string // ISO 8601 extraction time }, "warning": string (optional) // Present if content is thin (<200 words) }
For Markdown format: a formatted document with title, metadata summary, and the extracted markdown.
Counts against your monthly Extract quota (including cached requests). Use averra_check_usage to see remaining quota.
Examples:
Use when: "Summarize this blog post: https://example.com/post" → extract then summarize
Use when: "What does this docs page say about auth?" → extract then answer
Don't use when: You just need a link preview or metadata (this returns full content)
Don't use when: You need JSON extraction with a schema (not supported yet)
Error Handling:
400: URL rejected by safety checks (malformed, private IP, unreachable host) — check the URL resolves publicly.
401: Invalid API key — check AVERRA_EXTRACT_API_KEY env var
404: Page not found at URL
429: Monthly limit exceeded — upgrade plan or wait
502/503/504: Scraping service temporarily unavailable — retry
Inputs: url (required), response_format.
averra_list_api_keysList Extract API KeysARead-onlyIdempotent
List all API keys for the authenticated account.
Returns metadata only — the actual plaintext keys are never returned (only prefixes). Includes both active and revoked keys, ordered by creation date (newest first).
Args:
response_format ('markdown' | 'json', optional): Output format. Default 'markdown'.
Returns: For JSON format: { "keys": [ { "id": string, // Key ID (use for revoke operations) "key_prefix": string, // First 12 chars of key "plan": "free" | "starter" | "pro" | "scale", // Decorated from the account profile — identical across every key on the account. "monthly_limit": number, // Decorated from the account profile — identical across every key on the account. "is_active": boolean, // false if revoked "created_at": string, // ISO 8601 "revoked_at": string | null // ISO 8601 if revoked, null otherwise } ] }
Examples:
Use when: User asks "How many API keys do I have?"
Use when: Need to find a key's ID before revoking it.
Use when: Auditing which keys exist and their plans.
Error Handling:
401: Invalid API key — check AVERRA_EXTRACT_API_KEY
Inputs: response_format.
averra_revoke_api_keyRevoke Extract API KeyADestructiveIdempotent
Revoke an Extract API key by its ID. The key is immediately deactivated and cannot be reactivated — create a new key if needed.
SAFETY: You cannot revoke the key that is currently authenticating the MCP server itself (the one set in AVERRA_EXTRACT_API_KEY). Attempting to do so returns a 400 error.
Args:
id (string, required): The key ID to revoke. Get this from averra_list_api_keys.
response_format ('markdown' | 'json', optional): Output format. Default 'markdown'.
Returns: For JSON format: { "message": "API key revoked", "id": string, // The revoked key's ID "prefix": string, // Key prefix for confirmation "revoked_at": string // ISO 8601 revocation time }
This operation is destructive (cannot be undone) but idempotent (revoking an already-revoked key is safe).
Examples:
Use when: User explicitly asks to revoke a specific key.
Use when: Rotating keys — after confirming the new key works.
Don't use without user confirmation — this invalidates a credential.
Error Handling:
400: Attempting to revoke the currently-authenticating key — use a different auth key first
401: Invalid API key — check AVERRA_EXTRACT_API_KEY
404: Key not found or already revoked
Inputs: id (required), response_format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap: check_usage monitors quota, create_api_key and revoke_api_key manage key lifecycle, list_api_keys provides inventory, and extract_url performs content extraction. The descriptions explicitly differentiate use cases, preventing agent misselection.
All tools follow a perfect 'averra_verb_noun' pattern (e.g., averra_check_usage, averra_create_api_key), using snake_case consistently. The prefix 'averra_' identifies the server domain, and verb-noun combinations are uniformly applied across all five tools.
Five tools is well-scoped for the server's purpose of API key management and content extraction. Each tool earns its place: quota checking, key creation/listing/revocation, and the core extraction functionality, with no redundancy or obvious omissions for this focused domain.
The toolset provides complete coverage for API key lifecycle (create, list, revoke) and quota management, with the core extraction functionality included. A minor gap exists in lacking a tool for updating or managing account plans, but agents can work around this using existing tools for most workflows.
Maintenance
Related MCP Connectors
Jina AI Reader/Search MCP — turn any URL into clean LLM-ready markdown, plus web search.
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceAn MCP server for web content extraction that converts HTML pages into clean, LLM-optimized Markdown using Mozilla's Readability. It supports batch processing, intelligent multi-page crawling, and configurable caching while respecting robots.txt standards.48 npm-
- AlicenseAqualityCmaintenanceMCP server for web scraping — extract clean markdown, links, and metadata from any URL. Free Firecrawl alternative.5119 npm6MIT
- AlicenseAqualityBmaintenanceWeb extraction MCP server for AI agents. Extract structured data from any URL with built-in Cloudflare bypass, JavaScript rendering, and intelligent parsing. Returns clean markdown or JSON.5794 npm2MIT
- AlicenseAqualityBmaintenanceMCP Server for Web2MD — convert webpage URLs to clean Markdown from Claude Desktop, Cursor, or any MCP-compatible agent.12MIT