USPTO Final Petition Decisions MCP Server

Instructions

Implementation Reference

• src/fpd_mcp/main.py:1445-1485 (handler)

  The primary handler function for the 'FPD_get_guidance' tool. It takes a 'section' parameter and delegates to get_guidance_section from tool_reflections.py to return the appropriate guidance markdown.
  @mcp.tool(name="FPD_get_guidance") async def fpd_get_guidance(section: str = "overview") -> str: """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: - overview: Available sections and MCP overview (default) - workflows_pfw: FPD + PFW integration workflows - workflows_ptab: FPD + PTAB integration workflows - workflows_citations: FPD + Citations integration workflows - workflows_complete: Four-MCP complete lifecycle analysis - workflows_assistant: Pinecone Assistant + FPD research workflows - tools: Tool catalog, progressive disclosure, parameters - red_flags: Petition red flag indicators and CFR rules - documents: Document extraction, downloads, proxy configuration - ultra_context: PFW fields parameter + ultra-minimal workflows - cost: Cost optimization for document extraction Context Efficiency Benefits: - 80-95% token reduction (2-8KB per section vs 62KB total) - Targeted guidance for specific workflows - Same comprehensive content organized for efficiency - Consistent pattern with PFW MCP""" try: return get_guidance_section(section) except Exception as e: logger.error(f"Unexpected error in get guidance: {str(e)}") return f"Error: Internal error - {str(e)}"
• src/fpd_mcp/config/tool_reflections.py:9-36 (helper)

  Core helper function that implements the logic for the FPD_get_guidance tool by selecting and returning the appropriate guidance section based on the input parameter.
  def get_guidance_section(section: str = "overview") -> str: """ Get selective USPTO FPD guidance sections for context-efficient workflows. Args: section: Section name (default: "overview") Returns: Markdown-formatted string for requested section """ sections = { "overview": _get_overview_section(), "workflows_pfw": _get_workflows_pfw_section(), "workflows_ptab": _get_workflows_ptab_section(), "workflows_citations": _get_workflows_citations_section(), "workflows_complete": _get_workflows_complete_section(), "workflows_assistant": _get_workflows_assistant_section(), "tools": _get_tools_section(), "red_flags": _get_red_flags_section(), "documents": _get_documents_section(), "ultra_context": _get_ultra_context_section(), "cost": _get_cost_section() } if section not in sections: return f"Error: Section '{section}' not found. Available sections: {', '.join(sections.keys())}" return sections[section]
• src/fpd_mcp/main.py:1445-1445 (registration)

  The @mcp.tool decorator registers the fpd_get_guidance function with the name 'FPD_get_guidance' in the FastMCP server.
  @mcp.tool(name="FPD_get_guidance")
• src/fpd_mcp/main.py:1446-1446 (schema)

  The function signature defines the input schema: optional 'section' string parameter (default 'overview') and str return type. FastMCP uses this for tool schema generation.
  async def fpd_get_guidance(section: str = "overview") -> str:
• src/fpd_mcp/config/tool_reflections.py:102-102 (helper)

  Self-description of the tool within the guidance content generated by the tool itself.
  - **FPD_get_guidance**: Context-efficient sectioned guidance (this tool)