MCP Pricing
The MCP server draws from the same credit balance as your GoVeda web app and REST API — there is no separate MCP wallet. Every tool costs the same number of credits as the equivalent REST API operation. For what each tool does and its parameters, see the Tool reference.
Successful tool calls don’t echo the charge in their response. Check your balance with the get_usage tool (Claude, Cursor, and API-key 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 |
lookup_party | Resolve a company name to its standardized assignee form |
party_count | Verify assignee names exist and count their patents |
party_patents | List an assignee’s patents |
Per-call tools (flat rate)
| Tool | Cost |
|---|---|
get_patent | 1 credit / patent |
batch_get_patents | 1 credit / patent (up to 25 patents per 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 |
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 50 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 |