Buyer questions
Short answers to what buyers and agent builders ask most, each with a link to the page that covers it in full.
Getting started
Do I need an account?
Not to search quarry or read free datasets, and not for an agent that pays per question from its own wallet. You need one to subscribe to a dataset; your assistant then signs in to it to use your subscriptions. See How paying works.
Which address do I give my assistant?
In Claude, the free address, https://quarry.market/api/mcp: it works without an
account, and Claude asks you to connect yours when it needs it. The
Add quarry to Claude
link fills it in for you. In ChatGPT, the sign-in address,
https://quarry.market/api/agent/mcp. See Connect your tool.
Can my team share a subscription?
Yes. Subscribe from your organization's quarry account and give each teammate an API key from it: every key uses the same monthly questions. Claude and ChatGPT can't use API keys: they use the subscriptions of the quarry account they sign in with. See Share with your team.
Paying
Do I need crypto?
No. Subscriptions are paid by card, through Stripe. Only agents with their own wallet pay per question in USDC: see Give your assistant a wallet.
How much does a question cost?
The seller sets the price. Each dataset shows it on its public page and in search results: a price per question, a monthly subscription, or both. Some datasets are free. See How paying works.
What if the passages don't answer my question?
When quarry finds no passage that answers it, it says so and the question costs nothing, not even one of your subscription's questions. Passages that answer only part of it still count, so the free preview in search results and the dataset's description help your assistant pick the right dataset first. Questions paid one by one aren't refunded once answered. See What you pay for.
I paid by card, but my assistant still can't use the dataset
Check that your assistant is connected to the quarry account that subscribed: Claude asks you to connect it the first time it needs it, and other assistants use the sign-in address. Then check that the payment went through: on the Subscriptions page, Check payment status asks Stripe again. See Subscriptions and API keys.
Can I quote what I get?
Yes, with a citation: the file name, the page when there is one, and the dataset's listing. You may not resell passages, republish them in bulk, rebuild a dataset from them, or train models on them without the creator's permission. See What you can do with passages.
Do my agents share my questions?
Yes. Every agent connected to your account, and every API key, uses the same monthly questions for each subscription. See Subscriptions and API keys.
How do I cancel, or disconnect an agent?
Manage billing on the Subscriptions page opens Stripe, where you cancel; you keep access until the end of the month you paid for. Revoke, next to an agent under Connected agents, cuts that agent off right away without canceling anything. See Manage and cancel.
Privacy and results
Who sees what I ask?
quarry records the first 500 characters of every answered question, free ones included, and erases that text after 12 months. A question asked by an agent connected to your account, or with one of your API keys, is tied to your account however it is paid, and listed on your Purchases page: see Your purchases. A subscription's answer is also saved for 24 hours, so that a retry doesn't use a second question. One paid from a wallet without your account is tied to that wallet only, and its payment is public on the blockchain. Sellers see the text of questions paid one by one, with the amount and the receipt, but never which account asked, nor the text of free or subscription questions. Questions also go to the providers that run the search. See what others can see in the privacy policy.
How does quarry pick the passages?
It finds the passages closest to your question in meaning and in wording, then a second model reorders them so the most relevant come first. Each passage comes with its file, page, and the dataset's listing, so you can check it. See Result fields.
When something's wrong
My assistant says quarry wants a USDC payment
Your assistant isn't using a subscription for that dataset. It may not be connected to your quarry account yet: Claude asks you to connect it when it needs it (if it doesn't, see Chat assistants), and in ChatGPT, remove quarry and add the sign-in address. You may not subscribe to that dataset yet: subscribe on its public page. Or you've used this month's questions: the renewal date is on the Subscriptions page. To pay per question instead, see Give your assistant a wallet.
quarry says I'm asking too often
Wait a minute and try again. Searches are also limited per day, so if it keeps happening, connect with your account: an assistant signed in to your account, or an API key, gets limits of its own. See Limits.
My agent's wallet payment keeps failing
Check the network, the wallet's USDC balance, and that each question gets a new signed payment. See When a payment keeps failing.
Still stuck?
Signed in to quarry and found a bug? Click Report a bug in your account menu while you're on the page where it happens. For anything else, write to hello@quarry.market. Selling your own data? See Seller questions. Unsure of a word? See the glossary.