# Cloro — how to use (mcp.ai)

Connect your Cloro account and use 10 tools for web scraping straight from your AI agent. Connect with your own API key. Cloro provides structured data from Google Search and leading AI assistants, with synchronous extraction and asynchronous task APIs.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_cloro?ms=1787295900000`
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. `cloro_extract_ai_answer`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/cloro`
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/cloro/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/cloro/extract/ai/answer` — Synchronously extract a Gemini or Perplexity answer for a prompt and country. This spends credits and includes Cloro's 2-credit synchronous surcharge. Use Submit Async Task for ChatGPT or Copilot, whi
  - body: { state?: string, prompt: string, country: string, provider: string, include_html?: boolean, include_markdown?: boolean, include_raw_response?: boolean }
- `POST https://api.mcp.ai/api/cloro/extract/google/ai/mode/answer` — Extract a structured Google AI Mode answer with sources and optional rich modules for a prompt and country. This synchronous call costs at least 6 credits.
  - body: { uule?: string, device?: string, prompt: string, country: string, location?: string, include_html?: boolean, include_markdown?: boolean }
- `POST https://api.mcp.ai/api/cloro/get/async/queue/status` — Read organization-wide queued and processing counts, priority distribution, and current async concurrency without modifying the queue.
- `POST https://api.mcp.ai/api/cloro/get/async/task` — Get a queued Cloro task by ID, or wait with bounded polling until it reaches COMPLETED or FAILED. FAILED is returned as a valid terminal record with its provider response details intact.
  - body: { task_id: string, wait_for_completion?: boolean, poll_timeout_seconds?: number, poll_interval_seconds?: number }
- `POST https://api.mcp.ai/api/cloro/get/credits` — Read the organization's current completed-charge credit balance and billing cycle. Queued async work is not reserved, and even after a task reports a completed charge, the balance may take about 25 se
- `POST https://api.mcp.ai/api/cloro/list/supported/countries` — Return Cloro's current supported country codes, optionally filtered by provider model. This reports geographic support only and does not confirm that a provider monitor is operational.
  - body: { model?: string }
- `POST https://api.mcp.ai/api/cloro/list/us/states` — Return the US state and DC codes accepted for state-level targeting. State targeting applies only to ChatGPT, Gemini, Copilot, and Perplexity and adds 2 credits.
- `POST https://api.mcp.ai/api/cloro/search/google` — Extract structured Google web or Google News results from a query and country, or web results from a complete Google Search URL. This synchronous call costs at least 5 credits; extra result pages cost
  - body: { url?: string, uule?: string, pages?: integer, query?: string, device?: string, country?: string, location?: string, search_type?: string, include_html?: boolean, include_ai_overview?: boolean, include_paa_ai_overview?: boolean }
- `POST https://api.mcp.ai/api/cloro/submit/async/task` — Queue one non-cancelable Cloro monitor task and return its task ID and estimated credit charge without waiting. An accepted task continues after this call and spends the reported credits on completion
  - body: { task: object }
- `POST https://api.mcp.ai/api/cloro/submit/async/task/batch` — Queue 1-500 independently validated, non-cancelable Cloro monitor tasks. Each accepted task continues after this call and spends its reported credits on completion. Inspect summary, partial_success, a
  - body: { tasks: object[] }

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

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