quarryDocs

Subscriptions and API keys

Subscribe to a dataset by the month, connect your agents, create API keys for code, and share access with your team.

A subscription gives your quarry account a set number of questions per month on one dataset. Every agent connected to your account shares them. You need a quarry account: sign up if you don't have one.

Subscribe to a dataset

Open the dataset's public page from Explore and click Subscribe. Review the monthly price, the number of questions, and the usage terms, then pay by card in Stripe Checkout. Access starts once Stripe confirms the payment.

An assistant connected to your account can also prepare the Checkout link for you when it needs a dataset you don't subscribe to. Preparing the link charges nothing.

Connect your agents

Open Subscriptions. Under Connected agents:

  • For Claude, click Add to Claude: Claude opens with quarry filled in. Choose Sign in when needed, and connect your quarry account when Claude asks (see Chat assistants).
  • For other assistants, copy the Sign-in address, https://quarry.market/api/agent/mcp, and add it as a remote MCP server (see Connect your tool). When the assistant asks, sign in to quarry and click Connect agent.
The Connected agents panel of the Subscriptions page: the Add to Claude button, and the sign-in address for other agents with a Copy button.

A connected agent can see your subscriptions and a list of your latest purchases, without what was asked, use your subscriptions' questions, and prepare Checkout links. It can't edit your datasets, change your billing details, or withdraw money. To cut off one agent, click Revoke next to it: that takes effect right away and doesn't cancel your subscription.

Or use an API key

Code that can't run a sign-in, such as a script or an agent built with LangChain or the AI SDK, uses an API key instead. On the Subscriptions page, click Create key under API keys, name the key, and click Create key again. Copy the key right away: it's shown only once. Then click Done.

The API keys panel, with its Create key button.

Send it with every request to the free address, https://quarry.market/api/mcp:

Authorization: Bearer qk_...

A key can do what a connected agent can, nothing more: it can't sign in to your quarry account. You can have up to 10 active keys, and Revoke stops one immediately. Setup for each tool is in Connect your tool.

Share with your team

A subscription belongs to one quarry account, and that account can stand for your organization. To share its subscriptions:

  1. Subscribe from your organization's quarry account.
  2. On its Subscriptions page, create an API key for each teammate, agent, or server, named so you can tell them apart.
  3. Give each person their key, to set as QUARRY_API_KEY in their tools: see Coding agents and Other platforms.

Every key uses the same monthly questions, and Revoke cuts off one key without affecting the others. Every question asked with one of the account's keys is listed with its text on the account's Purchases page, whoever asked it. Claude and ChatGPT can't use API keys: they use the subscriptions of the quarry account they sign in with. The dataset's usage terms, shown on its page, still apply.

Your monthly questions

What counts as one question is on How paying works. For a subscription:

  • Your questions reset each month you pay for. Unused questions don't carry over.
  • When you run out, your agent can wait for the next month or, if the dataset also sells single questions, pay per question from its own wallet. quarry never buys extra questions for you.

Manage and cancel

Your subscriptions on the Subscriptions page shows what's left this month and when it renews. Subscriptions that have ended are folded under Ended, at the bottom.

  • Continue checkout picks up a payment you didn't finish.
  • Check payment status asks Stripe again if access hasn't started.
  • Manage billing opens Stripe, where you update your card, download invoices, or cancel.

Canceling stops the renewal; you keep access until the end of the month you paid for. If a seller stops selling a dataset, you keep access until your paid month ends.

Building something that checks access or subscribes on its own? See the Subscription API. Selling your own data by subscription? See Set your price.

On this page

View as Markdown