ChatGPT & Codex
Scrapier works in OpenAI’s tools through the same MCP server 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). |
-
Add the server:
Terminal window codex mcp add scrapier --url https://mcp.scrapier.io/mcp -
Sign in. A browser window opens for your Scrapier account:
Terminal window codex mcp login scrapier -
Check the daily credit limit on the Scrapier page and click Approve.
-
Start Codex and ask, for example, “How many Scrapier credits do I have?”
Prefer an API key? The MCP server page has the Codex snippet that sends one, with no browser sign-in.
ChatGPT
Section titled “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.
- 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).
- Enter the server URL
https://mcp.scrapier.io/mcpand choose OAuth for sign-in. - Sign in with your Scrapier account and click Approve.
- 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
Section titled “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 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. Codex also stops waiting for a tool after about a minute by default.
Your control
Section titled “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. 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
Section titled “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. |
| A scrape is refused as too slow | Use the REST API, or ask for another endpoint. |
Scraped pages are written by whoever controls the site, so treat results as data, not instructions. See Responsible use. Still stuck? See Support.