dev.averra/extract

Official

by Swwyymm · TypeScript

URL-to-Markdown API for AI pipelines — clean markdown with metadata and caching.

Convert URLs to clean, token-efficient Markdown with metadata caching.

Averra 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

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

Install

claude_desktop_config.json

{
  "mcpServers": {
    "extract": {
      "command": "npx",
      "args": [
        "-y",
        "@averra/extract-mcp@0.1.5"
      ]
    }
  }
}