Docs
Sign inStart free

Getting Started

Chab gives your AI agent one account for the tools and data it cannot reach on its own: web search, Google results and SEO data, maps and business details, contact lookup, scraping, screenshots, file conversion, translation, LLM calls and deep research. You can start without an account.

Start with your agent

Paste this into your AI agent (Claude Code, Codex, Cursor, ChatGPT, Claude and others):

Set up Chab for me: fetch https://www.chab.ai/agent-setup.md and follow it.

Your agent connects to Chab's hosted MCP server and opens a Chab page in your browser. Accept the terms and press Verify and connect: no account needed. Connect your agent has the steps for each app if you prefer to do it yourself.

Free trial, account and upgrades

  1. Free trial. Without an account you get a small one-off trial, about 50 credits for 7 days.
  2. Free account. When the trial runs out, your agent asks for your email address and signs you up. Open the email from Chab and press Confirm and continue. The credits left on the trial move into your account and you get bonus credits. Then reconnect your agent once; it tells you how. You can also sign up on the website any time.
  3. More credits. When you run out, your agent gives you a link to choose a plan or buy a credit pack, and you pay in your browser.

Trial and bonus credits are one-off and do not refresh. Free credits can pause for a while when the daily free-use limit is reached; paid credits are not affected. See free credits and limits and credits and billing.

Use the API directly

Prefer plain HTTP? Create an API key under API keys in your account, or a free guest key on the Chab home page without an account. Keep keys out of chats, URLs and shared files.

curl https://www.chab.ai/v1/health
curl https://www.chab.ai/v1/me \
  -H "Authorization: Bearer $CHAB_API_KEY"

Then start a tool, for example an email check:

curl -X POST https://www.chab.ai/v1/contacts/email-verify \
  -H "Authorization: Bearer $CHAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-first-email-check-001" \
  -d '{"email":"[email protected]"}'

Most tools return an operation. Poll its status_url, then read its result_url; see Operation Lifecycle. Use a new idempotency key for each new request.

CLI and local MCP

The Chab CLI works in terminals, scripts and agents that run shell commands. Install it with curl -fsSL https://www.chab.ai/install.sh | sh (Windows: irm https://www.chab.ai/install.ps1 | iex) and run chab login. See Connect your agent.

In your account

After signing in, the Overview shows your credits and how to connect your agent. Manage keys under API Keys, credits under Credits & Billing, and connected AI apps under MCP connections. The API Console lets you try a tool in the browser.

How Chab works

Most requests are operations. Some finish right away; others return status and result URLs so your agent or script can poll, long-poll, or get a webhook later. Read results with the same key or connection that started the operation.

Chab keeps request shapes, errors, credit estimates and results the same across providers, so scripts and agents do not need provider-specific logic.

Where To Go Next