# Zyte Api — how to use (mcp.ai)

Connect your Zyte Api account and use 7 tools for web scraping straight from your AI agent. Connect with your own API key. Zyte API is a web scraping solution that automates data extraction from websites, handling challenges like bans and dynamic content.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_zyte_api?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `zyte_api_active_scheduled_maintenances`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/zyte_api`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/zyte_api/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/zyte_api/active/scheduled/maintenances` — Retrieves currently active scheduled maintenances that are in 'In Progress' or 'Verifying' state. Use this to check for ongoing maintenance events that may affect Zyte API availability. Returns an emp
- `POST https://api.mcp.ai/api/zyte_api/components` — Retrieves all Zyte service components with their current operational status. Returns component details including status (operational, degraded_performance, partial_outage, major_outage), descriptions,
- `POST https://api.mcp.ai/api/zyte_api/extract/zyte/api` — Tool to extract data from URLs using Zyte API's HTTP, browser, and AI-powered extraction capabilities. Use when you need to scrape web pages, extract structured data (products, articles, jobs, etc.), 
  - body: { url: string, serp?: boolean, tags?: object, jobId?: string, ipType?: string, actions?: object[], article?: boolean, product?: boolean, echoData?: object, javascript?: boolean, jobPosting?: boolean, screenshot?: boolean, articleList?: boolean, browserHtml?: boolean, forumThread?: boolean, geolocation?: string, pageContent?: boolean, productList?: boolean, serpOptions?: object, articleOptions?: object, networkCapture?: object[], productOptions?: object, requestCookies?: object[], requestHeaders?: object, sessionContext?: object[], httpRequestBody?: string, httpRequestText?: string, customAttributes?: object, httpResponseBody?: boolean, articleNavigation?: boolean, httpRequestMethod?: string, productNavigation?: boolean, screenshotOptions?: object, productListOptions?: object, httpResponseHeaders?: boolean, jobPostingNavigation?: boolean, customAttributesOptions?: object, customHttpRequestHeaders?: object[] }
- `POST https://api.mcp.ai/api/zyte_api/get/scheduled/maintenances` — Tool to get the 50 most recent scheduled maintenances (upcoming and completed) from Zyte status API. Use after confirming you need the latest maintenance schedule for monitoring.
- `POST https://api.mcp.ai/api/zyte_api/get/unresolved/incidents` — Tool to retrieve unresolved incidents from Zyte status API. Use when you need to check currently open incidents.
- `POST https://api.mcp.ai/api/zyte_api/list/incidents` — Retrieves the 50 most recent incidents from the Zyte API status page, including both resolved and unresolved incidents. Use this tool to check current API health, review incident history, or get detai
- `POST https://api.mcp.ai/api/zyte_api/status` — Retrieves comprehensive operational status for all Zyte services. Returns current status of components (Zyte API, Smart Proxy Manager, Scrapy Cloud, etc.), active incidents, and scheduled maintenance 

## Example prompts
- "What can I do in Zyte Api?"
- "Show me a summary of my Zyte Api account"

## More
- Page: https://mcp.ai/zyte_api
- Agent spec (llms.txt): https://mcp.ai/zyte_api/llms.txt
- Postman collection: https://mcp.ai/zyte_api/postman.json