patent_landscape_async
ActiveTool of gapup-mcp
Async extended variant of patent_landscape. Supports max_results up to 200 (vs 50 in sync mode) and an optional include_citation_graph flag that enriches each patent with its 2-level citation graph (parent patents that cite this one + child patents cited by this one). Returns immediately (<300ms) with a job_id. Poll the result with patent_landscape_result(job_id) after eta_seconds (~180s). Use for deep R&D white-space analysis, freedom-to-operate (FTO) audits, VC due diligence IP mapping, or large-scale competitor portfolio analysis. Async tool — register a webhook via `webhooks_manage(register, url, [job.completed])` to receive callbacks instead of polling. Faster + lighter.
Parameters schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"mode": {
"enum": [
"search",
"landscape",
"lookup"
],
"type": "string",
"description": "search / landscape / lookup. Default: \"search\""
},
"query": {
"type": "string",
"maxLength": 500,
"minLength": 2,
"description": "Keywords, company/inventor name, or patent number (e.g. \"machine learning\", \"Tesla Inc\")"
},
"date_to": {
"type": "string",
"description": "ISO date YYYY-MM-DD — latest filing date"
},
"date_from": {
"type": "string",
"description": "ISO date YYYY-MM-DD — earliest filing date"
},
"max_results": {
"type": "number",
"maximum": 200,
"minimum": 5,
"description": "Max patents to return (5-200). Default: 20"
},
"jurisdictions": {
"type": "array",
"items": {
"enum": [
"US",
"EP",
"WO",
"CN",
"JP",
"KR"
],
"type": "string"
},
"description": "Jurisdictions to include. Default: [\"US\",\"EP\",\"WO\"]"
},
"include_citation_graph": {
"type": "boolean",
"description": "If true, enriches each patent with a 2-level citation graph (parents + children). Adds significant processing time — use for deep analysis only. Default: false."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
gapup-mcp
https://github.com/getgapup/gapup-mcp-public
2/7 registries