Chat assistants
Add quarry to Claude, ChatGPT, or another chat assistant as a custom connector.
In Claude, add quarry with the free address:
https://quarry.market/api/mcpClaude searches quarry right away, with no account, and asks you to connect your quarry account the first time it needs it, for example to use a subscription. One connector covers everything, which matters on plans that allow only one.
In ChatGPT, add the sign-in address instead, https://quarry.market/api/agent/mcp:
ChatGPT asks you to sign in to quarry (or create an account) when you add it.
Once connected, the assistant shows up under Connected agents on your Subscriptions page, where Revoke disconnects it. A connected account also gets its own search limits instead of sharing them with everyone who uses that assistant signed out.
Your assistant uses free datasets and your subscriptions: see How paying works. In the desktop app, Claude can also pay per question with a wallet of its own: see Give your assistant a wallet.
Claude
In Claude on the web or in the desktop app:
- Click Add quarry to Claude. Claude opens its Add custom connector window with quarry's name and address filled in: check them and click Continue.
- Under Authentication, choose Sign in when needed, leave the other settings as they are, and click Add.
- In a chat, turn quarry on from the + button at the bottom left, under Connectors.
- The first time Claude needs your quarry account, for example to use a subscription, it shows Authorization required above the message box. Click Reconnect, sign in to quarry (or create an account), and click Connect agent. Then ask your question again.
Without the link, open Customize → Connectors, click +, then Add custom connector, and paste the address. quarry then works in Claude on the web, in the desktop and mobile apps, and in Claude Code when you sign in to it with the same Claude account.
On the Free plan, you can add one custom connector. On Team and Enterprise plans, an owner adds quarry for everyone with the organization link, or under Organization settings → Connectors → Add → Custom → Web, with the address. Each member then finds it in Customize → Connectors, marked Custom, and connects their own quarry account when Claude asks. To share your organization's subscriptions, see Share with your team.
ChatGPT
Custom connectors need Developer mode, available on the Plus, Pro, Business, Enterprise, and Education plans, on the web. In a Business workspace, only admins and owners can create the app: ask one to follow these steps, then connect with your own sign-in.
- Open Settings → Security and login and turn on Developer mode.
- Go to Plugins, select +, and create a developer-mode app with the sign-in address.
- For authentication, choose OAuth. When ChatGPT asks, sign in to quarry and click Connect agent.
The new app is listed under Drafts in the app settings, where you can turn its tools on or off. With the free address, choose No Authentication instead.
Other assistants
Perplexity and Mistral Le Chat can add quarry's free address, to search quarry and read free datasets. We haven't confirmed that their sign-in works with quarry accounts yet, so use Claude or ChatGPT for your subscriptions.
- Perplexity (Pro, Max, and Enterprise): Account settings → Connectors → Custom connector → Remote. Enter the name and the free address, set Authentication to None and Transport to Streamable HTTP.
- Mistral Le Chat: Connectors → Add Connector → Custom MCP Connector. Enter the name and the free address, then click Connect. Only an admin can add connectors; on the Free, Pro, and Student plans, that's the account owner.
If something goes wrong
- Claude hasn't asked you to sign in: it asks only when it needs your quarry account. To connect it now, ask Claude how many questions you have left on your quarry subscriptions. If it still doesn't ask, quarry was added with No sign-in: remove it in Customize → Connectors and add it again with Sign in when needed.
- ChatGPT didn't ask you to sign in when you added quarry: you added the free address. Remove quarry and add the sign-in address instead.
- A paid dataset says it needs a subscription, or asks for a USDC payment: your quarry account isn't connected yet, you don't subscribe to that dataset, or you've used this month's questions (check Your subscriptions on the Subscriptions page). Subscribe on the dataset's public page, or ask the assistant to prepare the Checkout link for you: see Subscriptions and API keys.
- quarry says no passage answers the question: nothing was charged, and no question was used. Rephrase it, or try another dataset.
- quarry says you're asking too often: wait a minute. Searches are also limited per day. Signed out, that daily limit is shared with everyone else using the same assistant signed out; once your quarry account is connected, it counts only your own searches.