Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| USPTO_API_KEY | Yes | Your email address (required by USPTO for API access) | |
| USPTO_TIMEOUT | No | Timeout in seconds for USPTO API requests (optional, for tuning API request timeouts) | |
| FPD_PROXY_PORT | No | Local proxy port for standalone mode (only used when CENTRALIZED_PROXY_PORT is 'none') | 8081 |
| MISTRAL_API_KEY | No | Optional API key for Mistral OCR capabilities (for extracting text from scanned PDFs) | |
| CENTRALIZED_PROXY_PORT | No | Port for centralized proxy when USPTO PFW MCP is installed (set to 8080 when PFW is installed, or 'none' for standalone use) | none |
| USPTO_DOWNLOAD_TIMEOUT | No | Timeout in seconds for USPTO document downloads (optional, for tuning download timeouts) |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| Search_petitions_minimal | Ultra-fast discovery search for Final Petition Decisions (50-100 results). NEW: Minimal tier convenience parameters (9 total) - no query syntax needed! Use for: High-volume petition discovery, finding petitions by applicant, decision type, or date range. Returns: 8 essential fields - petition ID, application number, patent number, applicant name, decision type, petition mail date, decision date, deciding office. Convenience Parameters:
Examples: # Denied petitions for company
fpd_search_petitions_minimal(applicant_name="TechCorp Inc.", decision_type="DENIED", limit=50)
# Hybrid: keywords + convenience
fpd_search_petitions_minimal(query="machine learning", decision_type="DENIED", limit=50) Progressive Disclosure Workflow:
Cross-MCP Integration:
|
| Search_petitions_balanced | Balanced search for Final Petition Decisions with comprehensive fields (10-20 results). Balanced tier convenience parameters (14 total) - adds 5 advanced filters to minimal tier. Use for: Detailed petition analysis after minimal search, cross-referencing with PFW/PTAB data, analyzing petition types and legal context. Returns: 18 key fields including petition type, art unit, technology center, prosecution status, legal issues, CFR rules cited, statutes cited, entity status, and invention title. All Minimal Parameters (9) - same as Search_petitions_minimal:
Additional Balanced Parameters (5):
Examples: # Revival petitions (type 551) that were denied
fpd_search_petitions_balanced(petition_type_code="551", decision_type="DENIED", limit=20)
# Complex combination for quality analysis
fpd_search_petitions_balanced(
art_unit="2128", petition_type_code="551",
decision_type="DENIED", prosecution_status="During examination", limit=20
) Progressive Disclosure Workflow:
Cross-MCP Integration:
|
| Search_petitions_by_art_unit | Search petitions by art unit number for examiner/art unit quality analysis. Use for: Art unit quality assessment, systematic petition patterns, examiner behavior analysis. Returns balanced field set for cross-referencing with PFW examiner data and PTAB challenge rates. Example:
Analysis patterns:
Cross-MCP integration:
Parameters:
|
| Search_petitions_by_application | Get all petition decisions for a specific application number. Use for: Complete petition history, red flag identification, cross-referencing with PFW prosecution timeline. Examples:
Red flag analysis:
Cross-MCP integration:
Parameters:
|
| Get_petition_details | Get complete details for a specific petition by petition ID (UUID). ⚠️ CRITICAL: Proxy URLs in documentBag require proxy server to be running! MANDATORY WORKFLOW when include_documents=True:
Use for: Deep dive into specific petition, document metadata access, full legal context review. Returns:
Document access:
Parameters:
|
| FPD_get_document_download | Generate browser-accessible download URL for petition documents (PDFs) via secure proxy. ALWAYS-ON PROXY (DEFAULT): Proxy server starts with MCP - download links work immediately. Workflow:
CRITICAL RESPONSE FORMAT - Always format with BOTH clickable link and raw URL:
📁 | Raw URL: Why both formats?
Document types:
Parameters:
|
| FPD_get_document_content_with_mistral_ocr | Extract full text from USPTO petition documents with intelligent hybrid extraction (PyPDF2 first, Mistral OCR fallback). PREREQUISITE: First use fpd_get_petition_details to get document_identifier from documentBag. Auto-optimizes cost: free PyPDF2 for text-based PDFs, ~$0.001/page Mistral OCR only for scanned documents. MISTRAL_API_KEY is optional - without it, only PyPDF2 extraction is available (works well for text-based PDFs). USE CASES:
COST OPTIMIZATION:
Returns: extracted_content, extraction_method, processing_cost_usd, page_count Example workflow:
For document selection strategies and cost optimization, use FPD_get_guidance('cost'). |
| FPD_get_guidance | Get selective USPTO FPD guidance sections for context-efficient workflows. 🎯 QUICK REFERENCE - What section for your question? 🔍 "Find petitions by company/art unit" → tools 🚩 "Identify petition red flags" → red_flags 📄 "Download petition documents" → documents 🤝 "Correlate petitions with prosecution" → workflows_pfw ⚖️ "Analyze petition + PTAB patterns" → workflows_ptab 📊 "Citation quality + petition correlation" → workflows_citations 🏢 "Complete portfolio due diligence" → workflows_complete 📚 "Research CFR rules with Assistant" → workflows_assistant 🎯 "Ultra-minimal PFW + FPD workflows" → ultra_context 💰 "Reduce extraction costs" → cost Available sections:
Context Efficiency Benefits:
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| company_petition_risk_assessment_PFW | Analyze company petition track record for due diligence. At least ONE identifier required (company_name, application_number, or patent_number). include_details: true/false for detailed analysis. Requires PFW MCP. |
| art_unit_quality_assessment | Evaluate art unit prosecution quality via petition patterns. art_unit* (required). comparison_analysis: true/false for technology center comparison. |
| revival_petition_analysis | Find abandonment patterns and revival success rates. At least ONE required (company_name or art_unit). include_reasoning: true/false for Director's reasoning. outcome_focus: all/granted/denied/dismissed. |
| petition_document_research_package | Collect comprehensive petition documents. At least ONE required (petition_identifier or application_number). extract_text: true/false for text extraction. document_priority: high/medium/all for filtering. |
| complete_portfolio_due_diligence_pfw_ptab | Complete patent lifecycle risk assessment. company_name* (required). portfolio_size_limit: max applications to analyze (default 50). risk_scoring: true/false for risk scores. Requires PFW + PTAB MCPs. |
| litigation_research_setup_pfw | Prepare litigation research with prosecution + petition history. At least ONE required (patent_number or application_number). include_prosecution: true/false for prosecution history. priority_documents: litigation/due_diligence/all. Requires PFW MCP. |
| prosecution_quality_correlation_pfw | Correlate examiner patterns with petition frequency. At least ONE required (art_unit or examiner_name). statistical_analysis: true/false for correlation metrics. Requires PFW MCP. |
| patent_vulnerability_assessment_ptab | Correlate petition red flags with PTAB challenge outcomes. At least ONE required (company_name or patent_numbers). vulnerability_threshold: low/medium/high for risk sensitivity. predictive_analysis: true/false for vulnerability modeling. Requires PTAB MCP. |
| petition_quality_with_citation_intelligence_PFW_FPD_CITATIONS | Art unit petition quality assessment enhanced with citation intelligence. art_unit* (required). include_citation_analysis: true/false for citation analysis. analysis_depth: basic/standard/comprehensive for thoroughness. Requires PFW + FPD + Enhanced Citations MCPs. |
| examiner_dispute_citation_analysis_PFW_FPD_CITATIONS | Analyze citation patterns in examiner dispute petitions. At least ONE required (examiner_name or art_unit). petition_type: 37 CFR 1.137 (revival)/37 CFR 1.181 (examiner disputes)/37 CFR 1.182 (restriction). include_comparison: true/false for comparing disputed vs non-disputed apps. Requires PFW + FPD + Enhanced Citations MCPs. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |