> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# ChatGPT & Codex

Use Scrapier from Codex and from ChatGPT workspaces that allow custom MCP servers, signing in with your Scrapier account.

Scrapier works in OpenAI's tools through the same [MCP server](https://docs.scrapier.io/ai/mcp.md) that Claude uses. You sign in with your Scrapier account, and each connection gets its own daily credit limit that you can change or revoke.

|                |                                                                                                                                                                                                           |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Server URL** | `https://mcp.scrapier.io/mcp`                                                                                                                                                                             |
| **Sign-in**    | Your Scrapier account (OAuth 2.1), or an API key in Codex                                                                                                                                                 |
| **Cost**       | Free to discover endpoints and check your balance. Each successful scrape costs the endpoint's `cost_credit` (1 to 4 credits, depending on the endpoint; see [Credits & pricing](https://docs.scrapier.io/credits-and-pricing.md)). |

> **Scrapier isn't in the ChatGPT directory:** You add Scrapier yourself as a custom MCP server. It is not listed in OpenAI's public plugin directory.

## Codex

1. Add the server:

   ```bash
   codex mcp add scrapier --url https://mcp.scrapier.io/mcp
   ```

2. Sign in. A browser window opens for your Scrapier account:

   ```bash
   codex mcp login scrapier
   ```

3. Check the **daily credit limit** on the Scrapier page and click **Approve**.

4. Start Codex and ask, for example, "How many Scrapier credits do I have?"

Prefer an API key? The [MCP server](https://docs.scrapier.io/ai/mcp.md) page has the Codex snippet that sends one, with no browser sign-in.

## ChatGPT

Custom MCP servers are added on the ChatGPT website, not in the mobile apps. Which plans can add one is set by OpenAI and changes, so check your workspace settings. At the time of writing, Business, Enterprise and Edu workspaces have full custom MCP support, and some other plans are limited to read-only tools. Scrapier's `run_scrape` spends credits, so a read-only plan can't use it.

1. In ChatGPT, open the settings where you add a custom MCP server (in workspaces this is under plugins or connectors, and may need an admin).
2. Enter the server URL `https://mcp.scrapier.io/mcp` and choose **OAuth** for sign-in.
3. Sign in with your Scrapier account and click **Approve**.
4. In a chat, enable the server and ask for something, such as "Using Scrapier, find the scraper for Amazon product pages."

ChatGPT marks custom servers as higher risk, so expect a warning before you enable it.

## What it can do

The connector has six tools: `list_platforms`, `search_endpoints`, `get_endpoint_schema`, `run_scrape`, `get_scrape_result` and `get_account`. Discovery and balance checks are free. See [MCP server](https://docs.scrapier.io/ai/mcp.md#tools) for the table.

Some slower endpoints can't run from a connector. They are refused before anything is billed, and you can run them through the [REST API](https://docs.scrapier.io/quickstart.md). Codex also stops waiting for a tool after about a minute by default.

## Your control

- **Daily credit limit.** 1,000 credits per UTC day per connection by default. Lower it, or raise it up to 10,000, in [Connected apps](https://app.scrapier.io/dashboard/connected-apps). It can't be raised from inside the assistant.
- **Rate limits.** 60 tool calls per minute and 600 per hour per connection, and 3 scrapes at once across your connectors.
- **Revoke any time.** Revoking a connection in Connected apps disables its key straight away. A connection unused for 30 days is revoked automatically.

## Troubleshooting

| Problem                                                      | Fix                                                                                                             |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| Codex says it needs to log in                                | Run `codex mcp login scrapier` again.                                                                           |
| The sign-in page shows a different client name than expected | Check the name and redirect address on the consent page before you approve.                                     |
| The assistant says the daily limit was reached               | Wait for 00:00 UTC, or raise it in Connected apps.                                                              |
| ChatGPT won't let you add a custom server                    | Your plan or workspace may not allow it. Ask a workspace admin, or use Codex or another [MCP client](https://docs.scrapier.io/ai/mcp.md). |
| A scrape is refused as too slow                              | Use the [REST API](https://docs.scrapier.io/quickstart.md), or ask for another endpoint.                                                  |

Scraped pages are written by whoever controls the site, so treat results as data, not instructions. See [Responsible use](https://docs.scrapier.io/responsible-use.md). Still stuck? See [Support](https://docs.scrapier.io/support.md).

- [Claude connector](https://docs.scrapier.io/ai/claude.md): Add Scrapier to Claude with one link.
- [MCP server](https://docs.scrapier.io/ai/mcp.md): Every client, with an API key.
