Tool reference

This page lists everything you can ask Claude or ChatGPT to do through the Goveda Pro MCP server, grouped by where it fits in an examination. You don't need to call tools by name — just describe what you want ("start a project and upload this application", "run a prior art search", "show the unity analysis") and the assistant picks the right one. The names below are here so you know exactly what's available.

Tools marked interactive card open a rich, clickable panel inline (in Claude and other hosts that render them) instead of returning plain text — for example a projects dashboard, an upload picker, or a completed search-results panel.

Your connection is bound to the organization you signed in to — if you belong to more than one, you pick it during sign-in — and every tool then acts in that organization from the start.

Projects

For every project-specific tool, you can give either the Project UUID or the exact Singapore application number as project_id. An application number works when it identifies one Project you can read. If it matches several of your Projects, the assistant shows the candidate UUIDs and asks which Project to use. When starting a project with an application number already used by a readable Project, the assistant pauses and asks whether to continue that Project or create a separate one; it creates a separate Project only after you expressly choose that option.

ToolWhat it does
create_projectStart a new examination project. Pass application_no to pull the bibliographic data straight from the Singapore patent register; omit it to supply a PF1/PF37 instead.
list_projectsList your projects; filter by status or name.
get_projectOpen one project's details and current status.
show_projectsShow the projects dashboard. (interactive card)
submit_project_for_analysisQueue the project so the system runs the recommended prior art search, the summary, and the lack-of-unity analysis.
get_project_processing_statusCheck progress of each step. Claim features and claim comparison also appear here; those results are read in the web app, not through MCP — see the Roadmap.
show_project_processing_statusShow a live processing-status panel. (interactive card)
set_project_completionMark a project completed when the examination is done, or reopen it.
delete_projectDelete a project (project owner only).

The application document

ToolWhat it does
show_project_documentsShow the project's documents and upload new ones. (interactive card)
request_document_uploadGet an upload link for a file (manual upload flow).
add_documentAttach an uploaded file to the project and queue extraction.
list_project_documentsList the project's documents with their status and any processing error.
delete_project_documentRemove a document from the project.

Reading the application

ToolWhat it does
get_application_biblioBibliographic data — numbers, filing date, title, inventors, abstract, priority claims. For projects created from an application number, also applicants, IPC classifications, deemed filing date, and application type (Normal / PCT national phase / Divisional).
get_application_sequencesThe biological sequence listing (sequence patents only).
get_application_full_textRead the complete Effective Application Text as one Markdown document. Select abstract, claims, description, or any combination; omitting sections includes all three. Amended abstract and claims replace the base text, while the description retains base then amended text with provenance.
get_application_contentRead bounded or targeted abstract / claims / description content. The default is completion_required=false; reuse the exact cursor only when more content is needed. Explicit completion_required=true preserves the legacy completion guidance. available=false is not a cursor state.
search_application_contentFull-text search within the application and return the most relevant paragraphs.
get_application_summaryThe AI-generated application summary — workflow status and result — produced after you submit for analysis. Status initializing is also returned before submission; use get_project_processing_status to tell the two apart.

Project Knowledge Base

Reference PDFs uploaded through a project's Knowledge Base are extracted once by Goveda Pro, so an assistant can work with the resulting text without reading the PDF through a multimodal model. MCP access is read-only: upload, rename, retry, review, copy, download, and delete actions stay in the web app.

ToolWhat it does
list_knowledge_sourcesList the project's reference PDFs, newest first, with their processing status and page count. The list contains no document text; choose a source whose status is completed before reading it.
search_knowledge_baseSearch the extracted text of every completed reference PDF, or only selected sources. Relevance mode ranks likely matches; exact mode finds a literal phrase. Each bounded result identifies its source, original filename, PDF page, and content type. Use the returned cursor for more results, or read the selected source and page with get_knowledge_source_content.
get_knowledge_source_full_textRead one entire completed source as a single Markdown document, without page or cursor parameters.
get_knowledge_source_contentRead page-aware Markdown from one completed reference PDF. Use an inclusive page range to narrow the context, and reuse the returned opaque cursor when has_more is true. The default is a bounded read (max_chars=6000, completion_required=false); the tool does not call or summarize with a model.
get_knowledge_source_imageRetrieve one image from a Knowledge Base Markdown image URL, together with its source, PDF page, and caption. Call once per image. The connected assistant rechecks current project access, so an expired temporary browser link can still be resolved through MCP. The assistant reads the returned pixels rather than guessing from the caption. If its client cannot expose those pixels, it opens the original link through the client's browser permission flow; when that link has expired, copy the Markdown again. In ChatGPT's Chat mode, the image arrives as a file that ChatGPT asks you to allow, and project access is checked again when ChatGPT reads it.

Page-aware reads and Knowledge Base searches omit recognized page headers, footers, and printed page numbers. PDF page references remain available separately; numbers within body text and substantive footnotes remain part of the content. The original PDF and full-document Markdown are unchanged.

ToolWhat it does
get_recommended_prior_artThe system's recommended prior art for the application (produced automatically after you submit for analysis). Returns the shortlist by default; pass tier (most_likely, possible, or all) to widen or narrow it. Each recommendation includes its publication_date and a date_status: prior_art (published before the application's earliest valid priority date, or its filing date when there is none), conditional (published between that date and the filing date, filed earlier but published later, or undated — it counts only in some circumstances, such as a failed priority claim), or not_prior_art. For a PCT national-phase application the recommendations deliberately reach to the international filing date, so conditional documents can appear.
semantic_searchRun an ad-hoc semantic prior art search once and receive a completed first page of up to 10 hits inline — no success polling. Each compact hit has publication_number, nullable title, rank, and nullable url; use get_patent_full_text(publication_number, sections) for its abstract, claims, or description. By default it searches over the application and limits results to art published on or before the application's search cutoff date, the earliest_date from get_application_biblio (for a PCT national-phase application this is the international filing date, later than the priority date, so check each hit's date against the priority date; pass a later published_before to search past it, or published_after to set a floor). A free-text query can be up to 10,000 characters and cannot contain NUL. Filters accept up to 50 two-letter patent-office codes, up to 100 IPC/CPC symbols such as G06F 21/60, and patent status alive or dead. To search without a project, pass project_id="personal" together with query and published_before; the search is kept in your own search history, visible only to you, and its later pages come from get_search_results with project_id="personal". Personal searches cannot be filtered, exported, or shown on a card.
filter_prior_artSynchronously post-filter either the original recommended pool or a completed user search. mode="keyword" scans at most the original top 2,000 candidates with patent-highlight-v1 expressions and preserves source order; mode="semantic" selects only from that existing pool for the supplied query_text and keeps top_k matches (default 5, maximum 50). Each mode persists the complete ordered subset and returns a compact first page plus filter_id, total, and normalized filter_conditions. Provide only the parameters for the selected mode, and omit all parameters belonging to the other mode.
get_search_statusCheck an older or otherwise in-progress search ID. A successful new semantic_search or show_semantic_search call is already complete and does not need this step.
get_search_resultsRead a historical search ID or fetch later result pages using offset and limit (1–100). Pass the optional filter_id returned by filter_prior_art to page through a persisted filtered subset; omit it for the original search. Use next_offset when has_more is true. Pass project_id="personal" to read your own searches that belong to no project.
show_semantic_searchRun the same one-call search as semantic_search and show its completed compact results and criteria on a card; click a hit to open its full patent card. Takes the same bounded options as semantic_search. (interactive card)
lookup_classificationsFind authoritative CPC/IPC codes from a keyword, a symbol, or a plain-language description. Topic results match classification titles and hierarchy, with one row per symbol.
get_application_family_citationsGet patent and non-patent-literature citations raised against this application's family. It returns independent patent and npl sections by default, so either section remains available if the other fails. Pass citation_type (all, patent, or npl) to choose sections; scope defaults to simple and can be extended for broader patent-family coverage. Each NPL citation keeps its original text and includes a link to a stated DOI or, when no DOI is available, a Google search built from the available citation details.

Patent lookup

Scope defaults are deliberately narrow. Family sections return the same-priority family (family_scope="simple"), and backward citations return only what the publication itself cites (scope="patent"). This keeps results precise, but it means the lists are shorter than a full-coverage search. When you need the widest net — a prior art sweep, an opposition, a validity study — ask for the extended scope explicitly: family_scope="extended" on the patent and family lookups, and scope="extended" on the backward citation tools. (Forward citations already default to the full family, and extended is not a valid scope there — use scope="family".)

ToolWhat it does
get_patent_full_textThe default way to read a patent's text: complete available abstract, claims, description, or any selected combination as one Markdown document, one patent per call. It retains the title, publication number, and patent link, and does not include family, legal-event, or citation data.
get_patentLook up bibliographic data, legal events, family, or specific paragraphs as structured fields; long text is bounded with cursor continuation, so read complete text with get_patent_full_text. The default is completion_required=false; explicit completion_required=true retains the legacy completion guidance. Publication, Application and PCT references resolve to their preferred publication. Ambiguous references require candidate confirmation; unproven references return UNRESOLVED_REFERENCE. UPSTREAM_UNAVAILABLE means identification is temporarily unavailable, not no results. (citations use dedicated tools)
discover_patent_referencesFind readable publication candidates for unresolved references. Results stay aligned with the input list and may contain an empty candidate list or a per-reference upstream error. Candidates are possibilities for review, not proof of identity; the assistant uses one only after you select it or your original request explicitly authorizes choosing a likely match.
search_patent_contentSearch within one patent and get back its GoVeda URL plus the matching paragraphs, ranked, each with its paragraph number — so you can locate a passage and read it in context with get_patent. Where a document numbers no paragraphs, the number comes back as null, never as invented. When you will cite the passage in an opinion, ask with locate=true: each description hit then carries cite, the paragraph number printed on the published PDF (for example "D1 [0064] discloses…"), which can differ from the paragraph number above for some offices such as China. A copied passage finds its paragraph even with small differences. The first locate on a patent can take a little longer; a scanned PDF may answer "processing" — ask again in a minute. Where the PDF prints no paragraph numbers, cite gives the column and lines for US grants ("col. 5, ll. 30–39") and the printed page and lines for other documents ("page 5, lines 8–9"; Chinese documents give both the full-document and the description page). When no position can be established, cite says why.
list_patent_imagesList a patent's available images without loading their pixels. Returns ordered filenames and compact image IDs, with pagination (50 per page by default, up to 100). Display positions are not figure numbers. The list returns before images are prepared; each image is prepared when first retrieved. complete=false means images may still be missing; stale=true identifies a last-known listing. Signed image links and expiries stay out of the assistant context. No Project is required.
get_patent_imageRetrieve one selected image using its publication number and compact image ID, with its patent page and filename. The temporary rendition link remains internal and a removed image is not silently substituted. The assistant must inspect the returned pixels, not guess from the filename. No Project is required. If the image is still being prepared, the call waits up to about 40 seconds, then says how long to wait before trying again. In ChatGPT's Chat mode, the image arrives as a file that ChatGPT asks you to allow.
batch_get_patentsScreen several patents at once in bounded rows; not complete text. Number resolution is performed as one verified batch while preserving input order and duplicate rows. Use get_patent_full_text separately for any patent whose complete body is required. If the lookup is temporarily unavailable, the call returns one top-level operation error instead of per-row “not found” results.
show_patentShow a patent card, or a side-by-side comparison of several patents. (interactive card)
get_patent_forward_citationsThe patents that cite a given patent (forward citations), paginated. scope defaults to family, matching the web view; pass patent for this publication only.
get_patent_backward_patent_citationsThe patents a given patent cites (backward patent citations), paginated. Each citation preserves cited_as and identity; only exact or resolved targets have links. Ambiguous candidates need confirmation, and unavailable targets remain visible for later identification. scope defaults to patent — only what this publication itself cites.
get_patent_backward_npl_citationsThe non-patent literature a given patent cites, paginated. scope defaults to patent — only what this publication itself cites.

Lack of Unity

ToolWhat it does
get_lou_analysisThe lack-of-unity result — whether the claims lack unity, the reasoning, and the generated Section 4 text.
show_lou_analysisShow the LOU analysis card — verdict, invention groups, and Section 4 text with one-click copy. (interactive card)

Export

ToolWhat it does
export_prior_art_csvExport the recommended prior art, or a completed semantic search's results, as a downloadable CSV (link expires in 1 hour). For the recommended prior art, tier (most_likely, possible, all) selects how much of it to export.

Feedback

ToolWhat it does
submit_feedbackSend a bug report, feature request, or general feedback about Goveda Pro.

What's next

For web-app capabilities not yet exposed through the MCP server — and everything else in progress — see the Roadmap.