Hosted MCP server

Search and extraction
for MCP clients.

Connect an MCP-compatible client directly to extractor.sh. The hosted server is stateless and supports the free anonymous daily allowance or an optional account Bearer key using the account's credit balance. New accounts receive 1,000 welcome credits once.

Endpoint

https://extractor.sh/mcp

The endpoint uses Streamable HTTP. Add it as a remote HTTP MCP server in your client. A common configuration shape is:

{
  "mcpServers": {
    "extractor": {
      "url": "https://extractor.sh/mcp"
    }
  }
}

Client configuration keys vary. If your client only launches local commands, use its supported remote-MCP bridge and point that bridge at the endpoint above.

To use welcome or purchased credits, configure the HTTP header Authorization: Bearer ext_live_… in clients that support remote-server headers. The key is forwarded into the same cache-first metering service used by the GET API.

Tools

extract_public_url

Extract one ordinary public page URL. The tool is read-only and accepts:

Choose Markdown when an agent will read or summarize the result. Choose JSON for stable, typed fields using schema version 1.

search_web

Find public pages when no exact URL is known. The tool returns ordered titles, URLs, and snippets and accepts:

Use search_web for discovery and extract_public_url for the full content of a selected result.

search_images

Find openly licensed public images with source pages, media URLs, creators, dimensions, and license metadata. It accepts a required query, optional format, a limit from 1 to 20, and the same usage and orientation controls as the image GET API.

search_places

Resolve a named place or address into coordinates, normalized address fields, categories, and canonical map links. It accepts the place GET API’s language, optional country, paired lat/lon bias, and type controls.

search_news

Search current public news with a query, format, limit from 1 to 50, language, country, and optional timeframe of any, 1h, 1d, 7d, or 30d.

search_stocks

Resolve a company name, brand, or partial ticker into up to ten ordered equity listings. Results expose the market symbol, exchange, listing currency, and sector or industry when available. Use this before get_market_data when a user has not supplied a reliable symbol.

get_market_data

Retrieve a market snapshot and bounded price history. Pass a symbol such as AAPL, ^GSPC, BTC-USD, or EURUSD=X, plus an optional finance timeframe and output format. When the user asks for a currency, pass the optional three-letter quote directly—for example, { "symbol": "AAPL", "quote": "EUR" }. Do not make a separate exchange-rate tool call. The default JSON result includes schema-v1 structuredContent so an AI chat can reason over the exact converted price points instead of reading pixels or reparsing prose.

Rich finance chart

get_market_data links to a bundled MCP Apps resource. Compatible AI chats render a responsive line chart inline with the conversation, including the current price, change, timeframe, hover and keyboard inspection, and available range statistics. The chart uses the same bounded history returned by the tool and makes no separate market-data or third-party chart request.

MCP Apps is progressive enhancement. Clients without resource UI support still receive the normal text block and typed JSON result, so the model can answer the question and a client can build its own chart. Markdown remains available as the readable fallback.

Example task

Extract pricing from serper.dev.

An MCP client can select extract_public_url, construct https://serper.dev/, and pass pricing as the focus. Topic focus keeps a large landing-page demo or navigation from displacing the requested section.

Limits and safety

• The same 10/day anonymous allowance, account credit balance, and standard request limit as the GET API apply. Only extraction can use the separate high-cost limit.
• MCP and GET requests share their corresponding Cloudflare edge cache entries. Focused extraction results use separate topic-aware entries. Cache hits do not consume a request.
• Only public HTTP and HTTPS URLs are accepted for extraction. Do not send credentials, cookies, private URLs, or private data.
• CAPTCHAs, login walls, paywalls, and region selection are not supported.
• Tool errors include a stable error code and a specific human-readable message.

Discovery

The public MCP Server Card describes the endpoint, transport, authentication status, tools, and finance UI resource. The runtime tool and resource definitions remain authoritative.