MCP Pricing
The hosted MCP server draws from the same Subscription credit balance as the GoVeda web app. Direct REST API requests use a separate API Credit balance. Tool costs match the equivalent operation, but the two balances do not consume each other.
Successful tool calls don’t echo the charge in their response. Check your balance with the get_usage tool (Claude, Cursor, and other MCP clients — not exposed in ChatGPT), or on the Plan & Credits page. A call that fails for insufficient credits returns credits_required and credits_remaining so your AI assistant can explain the shortfall.
Free tools
These never consume credits, no matter how many times you call them.
| Tool | What it does |
|---|---|
get_usage | Check credit balance and billing period |
get_search_status | Poll a prior_art_search in progress |
get_report_status | Poll a generate_novelty_report in progress |
get_report_summary | Read a completed report’s executive summary and patent directory |
get_report_patent_analysis | Read a completed report’s per-patent analysis |
lookup_classifications | Resolve a keyword or symbol to CPC/IPC classification codes |
discover_patent_references | Find available publication candidates for unresolved references without selecting one |
Per-call tools (flat rate)
| Tool | Cost |
|---|---|
get_patent | 1 credit / patent |
get_patent_full_text | 1 credit / patent |
batch_get_patents | 1 credit / patent (up to 25 patents per call) |
search_patent_content | 1 credit / call |
get_patent_translations | 1 credit / call |
get_patent_transfers | 1 credit / call |
get_patent_forward_citations | 1 credit / call |
get_patent_backward_patent_citations | 1 credit / call |
get_patent_backward_npl_citations | 1 credit / call |
get_patent_attachments* | 1 credit / call |
lookup_party | 1 credit / call |
party_count | 1 credit / call |
party_patents | 1 credit / page |
generate_novelty_report | 720 credits / report |
* get_patent_attachments is behind a feature flag and not available to every account yet.
generate_novelty_report’s 720 credits is a flat, all-inclusive price. It covers the embedded prior-art search — which would cost 690 to 2,850 credits on its own at the tiers below — plus analysis of up to 100 patents. Running the two steps separately would cost more.
Tiered tools
semantic_patent_search and prior_art_search scale with the limit parameter: more results cost more credits, but the marginal cost per result drops as limit grows.
| Tool | Cost range |
|---|---|
semantic_patent_search | 50 credits (limit ≤ 10) to 590 credits (limit = 1,000) |
prior_art_search | 690 credits (limit ≤ 10) to 2,850 credits (limit = 1,000) |
Semantic search
limit range | Formula |
|---|---|
| 1–100 | 20 + 30 × ⌈limit / 10⌉ |
| 101–1,000 | 290 + 30 × ⌈limit / 100⌉ |
limit | Credits |
|---|---|
| 10 (default) | 50 |
| 20 | 80 |
| 100 | 320 |
| 200 | 350 |
| 1,000 | 590 |
Prior art search
Default limit is 50.
limit range | Formula |
|---|---|
| 1–100 | 600 + 90 × ⌈limit / 10⌉ |
| 101–1,000 | 1,350 + 150 × ⌈limit / 100⌉ |
limit | Credits |
|---|---|
| 10 | 690 |
| 50 (default) | 1,050 |
| 100 | 1,500 |
| 200 | 1,650 |
| 1,000 | 2,850 |