If the answer you need is not here, ask us.
Getting started
What is VerveContext?
204 sources across 24 categories, exposed to an agent as tools. Validation, geolocation, financial data, DNS and domain tooling, text processing. Each one carries an input schema the model can read and an output schema that brings the answer back as data — one connection, and the whole catalog is callable.
How do I get an API key?
Sign up at dashboard.vervecontext.com and a key is generated for you. It is on the API keys page. No credit card, and the free plan has calls in it immediately.
How quickly can I get started?
A few minutes. Quickstart is one URL in your client's config and a sign-in — the tool list arrives on its own.
Which clients work?
Anything that speaks MCP over HTTP — Claude, Cursor, VS Code and others. Clients that still require a local stdio process can use the official Docker bridge. See MCP server.
Is there a free tier?
Yes, and it is a real plan rather than a timed trial — it renews every month:
| Plan | Price | Credits / month | Rate limit |
|---|---|---|---|
| Free | Free | 200 | 5/min |
| Starter | $29.99/mo | 200,000 | 60/min |
| Pro | $99.99/mo | 1,000,000 | 180/min |
| Mega | $299.99/mo | 4,000,000 | No limit |
Do I need a credit card to sign up?
No. Payment details are only needed to move to a paid plan.
Can I use VerveContext for commercial projects?
Yes, on a paid plan. See pricing for the terms attached to each plan.
Is there a sandbox or test environment?
There is no separate sandbox, because there is no separate behaviour to test against — every source works identically on every plan, so the free plan is the test environment.
Keys and security
How do I authenticate?
Once, when the client connects — either the OAuth flow your client runs, or a key in its config header. Individual tool calls are authenticated for you. See authentication.
Can I have more than one key?
Every account has one primary key. Sub-keys are additional credentials that bill to the same account and can be scoped and revoked independently — the right tool for a per-environment or per-client credential.
| Plan | Sub-keys |
|---|---|
| Free | Not included |
| Starter | Not included |
| Pro | 5 |
| Mega | 25 |
Can I regenerate my key?
Yes, from the API keys page. Rotation is instant and there is no grace period: the old key stops working the moment the new one exists, so update your applications first rather than after.
What do I do if my key is exposed?
Rotate it immediately, which invalidates the old one at once. Then check analytics for usage you do not recognise — that is the clearest sign someone else has been using it. If the key was committed to a repository, remember it is still in the history after you delete the line.
Is my data secure?
Requests are TLS-encrypted and plain HTTP is not served. We keep metadata about calls — timestamp, source, status — because that is what analytics and support are built from. Request and response bodies are not retained beyond serving the request.
Can I restrict what a key can do?
Yes. Key scoping blocks specific sources, and on Mega you can also allow-list IPs and cap a key's own rate limit. Worth doing for anything running outside your own infrastructure.
Credits and billing
What is a credit?
The unit of usage. Most calls cost one credit; heavier ones cost more, and each reference page states its own cost. Failed calls are not billed — if the call errors, no credit is taken.
How do I stop an agent spending more than I expect?
An agent decides how many calls to make, so bound it rather than watch it. Give each agent its own sub-key, which gives it its own rate limit and its own line in the usage breakdown, and use key scoping so it can only reach the tools it is for. Analytics is where a retry loop shows up.
What happens when I run out?
Calls are refused with a message saying the monthly credit limit has been reached. Credits return on your renewal date, or you can upgrade for an immediate increase.
Both an exhausted balance and a per-minute rate limit return 429, and they need opposite
responses — backing off fixes a rate limit and does nothing at all for an empty balance. Tell
them apart with the x-api-remaining-credits response header: 0 means credits, anything else
means rate.
When do credits reset?
On your renewal date each month — signup anniversary on the free plan, subscription anniversary on a paid one. The exact date is in analytics.
Do unused credits roll over?
No. Each cycle starts fresh at your plan's allowance.
Can I see my usage?
Yes — in analytics. Pro and Mega also get the daily trend and the per-source breakdown.
What do the plans cost?
| Plan | Price | Credits / month | Rate limit | Concurrent calls |
|---|---|---|---|---|
| Free | Free | 200 | 5/min | 1 |
| Starter | $29.99/mo | 200,000 | 60/min | 5 |
| Pro | $99.99/mo | 1,000,000 | 180/min | 20 |
| Mega | $299.99/mo | 4,000,000 | No limit | 50 |
Current details are on pricing.
Can I change plan mid-cycle?
Yes. Upgrades apply immediately and are prorated; downgrades apply at the next cycle, so you keep what you have already paid for.
What payment methods do you take?
Major credit and debit cards, processed by Stripe. Enterprise customers can arrange invoicing — ask.
Do you offer refunds?
There is a 30-day money-back guarantee. Contact support and we will sort it out.
Can I cancel?
Any time, from billing. Access continues to the end of the period you have paid for, and the account then reverts to the free plan rather than being closed.
Technical
What are the rate limits?
A per-minute ceiling per plan, plus a limit on how many calls may be in flight at once:
| Plan | Rate limit | Concurrent calls |
|---|---|---|
| Free | 5/min | 1 |
| Starter | 60/min | 5 |
| Pro | 180/min | 20 |
| Mega | No limit | 50 |
When you hit one the response is a 429 carrying x-rate-limit-limit,
x-rate-limit-remaining and x-rate-limit-reset. See rate limits.
How do I handle errors?
Every response has status, error and data. Check status rather than whether data looks
populated — a lookup that legitimately found nothing is a success, not a failure.
| Status | Meaning |
|---|---|
400 | A parameter is wrong; the message names it |
401 | The key is not valid — the only status that means this |
403 | The key is valid but not allowed to make this call — scoping or an IP restriction |
404 | No such source on this door |
429 | Rate limit, or out of credits |
5xx | Our problem — retry with backoff |
Retry 429 and 5xx. Never retry a 400: it will fail identically the second time.
Errors covers each in full.
What is the average response time?
It varies by source, and each reference page shows its own typical latency. Live figures are on status.apiverve.com.
What is the uptime?
We target 99.9%. status.apiverve.com carries live status, history and maintenance notices.
Is there documentation for every source?
Yes. Every source has a reference page with its parameters, response fields, credit cost, typical latency and worked examples. Browse them from the catalog.
When something is wrong
My key is correct but I get a 403
A 403 never means "we do not recognise this key" — that is 401, and only 401. A 403 means
the key is real and the account is fine, but this particular call is not permitted: either the
source is blocked by key scoping, or the request came from an
address that is not on the key's IP allow-list.
Check the key's restrictions in the dashboard before you go looking for a credential problem. The most common cause is a scoped key meeting a source that was added to the integration later.
Everything returns 429 and backing off does not help
Then it is not the rate limit, it is the balance. Both return 429. Read
x-api-remaining-credits on the response: 0 means you are out of credits and no amount of
waiting inside the cycle will change it. Retrying in that state is actively harmful — it makes
no progress and fills your logs.
A source is in the catalog but returns "not found"
Each brand serves its own subset, and a source that is not part of the door you are on behaves exactly like one that does not exist. That is deliberate: the answer does not reveal what you cannot reach. The catalog on this site is this door's catalog, so anything listed here is available to you.
A field the documentation mentions is missing
Premium fields are absent on plans that do not include them, rather than present and empty. That is deliberate: absent is unambiguous, whereas an empty value could mean "we looked and found nothing".
Each reference page marks which fields are premium.
My integration broke suddenly and nothing changed on my side
The usual cause is a key rotation — it takes effect instantly and everywhere, so a rotation done for one system silently breaks every other system holding that key.
Account and support
What happens to my data if I downgrade or cancel?
The account reverts to the free plan rather than being deleted, and your key keeps working at free-plan limits. Features above that plan stop being available — sub-keys beyond the free allowance, the detailed analytics breakdown — but nothing is destroyed, and upgrading again restores access.
How do I upgrade?
From plans in the dashboard. It takes effect immediately.
Do you offer enterprise plans?
Yes — custom limits, SLA terms and dedicated support. Talk to us.
Can I request a new source?
Please do. Tell us what you need and what you would use it for. The use case matters more than the name, and a good one moves it up the list.
How do I delete my account?
Contact support and we will remove it, as described in the privacy policy.
How do I get help?
apiverve.com/contact — usually within a day on business days. For anything that looks like an outage, check status.apiverve.com first.
Next
Quickstart is the fastest first call, and the glossary explains the terms used across these pages.