PyPI - govconapi-mcp - Versions diffs - 0.2.1__tar.gz → 0.2.2__tar.gz - Mend

govconapi-mcp 0.2.1tar.gz → 0.2.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

govconapi_mcp-0.2.2/Dockerfile ADDED Viewed

@@ -0,0 +1,17 @@
+# Image for running the GovCon API MCP server (stdio transport). Used by Glama's build and
+# security checks, and by anyone who wants to run the client in a container.
+#
+# Introspection works with no configuration: the API key is read at CALL time inside core._get(),
+# not at import, so `tools/list` returns all 53 tool definitions without a key and without network
+# access. Actually invoking a tool does need a key, since every tool is a live query against
+# https://govconapi.com. Free 14-day trial, no credit card: https://govconapi.com
+FROM python:3.12-slim
+WORKDIR /app
+COPY . /app
+RUN pip install --no-cache-dir .
+# GOVCONAPI_KEY is required to call tools, not to list them.
+# GOVCONAPI_BASE is optional and defaults to https://govconapi.com.
+ENTRYPOINT ["govconapi-mcp"]

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: govconapi-mcp
-Version: 0.2.1
+Version: 0.2.2
 Summary: MCP server for GovCon API: 53 tools spanning the federal contracting lifecycle (market research, opportunity discovery, capture and teaming, bid and proposal, award and compliance) for Claude Desktop, Claude Code, Cursor, Zed, or any local MCP client.
 Project-URL: Homepage, https://govconapi.com
 Project-URL: Documentation, https://govconapi.com/api-guide
@@ -27,11 +27,13 @@ Description-Content-Type: text/markdown
 # GovCon API MCP
-![MCP server](https://img.shields.io/badge/MCP-server-5865F2) ![53 tools](https://img.shields.io/badge/tools-53-1f6feb) ![corpus](https://img.shields.io/badge/corpus-10.8M_FPDS_transactions-1f6feb) [![from $19/mo](https://img.shields.io/badge/from-%2419%2Fmo-2ea44f)](https://govconapi.com/pricing)
+![MCP server](https://img.shields.io/badge/MCP-server-5865F2) ![53 tools](https://img.shields.io/badge/tools-53-1f6feb) ![5 federal sources](https://img.shields.io/badge/sources-5_federal-1f6feb) [![from $19/mo](https://img.shields.io/badge/from-%2419%2Fmo-2ea44f)](https://govconapi.com/pricing)
 **Most SAM.gov MCP servers wrap one dataset behind six to ten tools. This is 53 tools across five federal sources, already joined on the identifiers they share, including full text extracted from inside solicitation attachments.**
-US federal procurement data for agents: **668,576** SAM.gov opportunities, **10,787,941** FPDS prime contract transactions, **887,310** SAM-registered entities, **225,945** FFATA subawards, **164,322** exclusions, **13,778** decided GAO protests, and **~262,000** GSA CALC labor rates. Cross-linked on UEI, CAGE, PIID and NAICS, so one question does not become five integrations.
+US federal procurement data for agents: **668K** SAM.gov opportunities, **10.6M** FPDS prime contract transactions, **880K** SAM-registered entities, **226K** FFATA subawards, **164K** exclusions, **14K** decided GAO protests, and **~262K** GSA CALC labor rates. Cross-linked on UEI, CAGE, PIID and NAICS, so one question does not become five integrations.
+*Counts as of 2026-08-31, rounded. The corpus grows daily, so this file is a snapshot: current per-source totals and freshness dates are always live at [`/api/v1/status`](https://govconapi.com/api/v1/status), no key required.*
 > **Free 14-day trial, no credit card.** [Get a key](https://govconapi.com), then `pipx install govconapi-mcp`.
@@ -41,7 +43,7 @@ US federal procurement data for agents: **668,576** SAM.gov opportunities, **10,
 Most federal-contracting MCP servers are thin proxies over the official SAM.gov API. Four concrete differences.
-- **It searches inside the documents, not just the notice.** We extracted and indexed the full text of **506,382 documents** attached to **209,095 opportunities**, 31.4 billion characters, including **57,527 files recovered from archives nested up to five levels deep** that never appear in SAM's own attachment list, and **41,764 scanned documents recovered with OCR** (measured 2026-07-16). A requirement like CMMC, a clearance level, or an option year is usually in the SOW, not the notice. Most tools structurally cannot see it.
+- **It searches inside the documents, not just the notice.** We extract and index the full text of every document attached to a notice. A corpus study on **2026-07-16** measured **506,382 documents** across **209,095 opportunities**, 31.4 billion characters, including **57,527 files recovered from archives nested up to five levels deep** that never appear in SAM's own attachment list, and **41,764 scanned documents recovered with OCR**. Those five figures are one dated measurement and belong together; the index has grown since, and the running total is on [`/api/v1/status`](https://govconapi.com/api/v1/status). A requirement like CMMC, a clearance level, or an option year is usually in the SOW, not the notice. Most tools structurally cannot see it.
 - **Five sources, already joined.** SAM.gov opportunities and entities, FPDS contract transactions, USAspending/FFATA subawards, SAM exclusions, SBA DSBS certifications and GSA CALC rates, resolved onto shared identifiers. A wrapper hands your agent one dataset and leaves the joins to it.
 - **No SAM.gov entity registration and no company UEI required.** GSA documents 10 requests/day for a non-federal user without a SAM role, and 1,000/day with one. Access here is an email and a key.
 - **53 tools, organised by lifecycle stage.** Market research, opportunity discovery, capture and teaming, bid and negotiate, award and compliance. You should not have to know our URL structure to know which tool answers your question.
@@ -145,11 +147,27 @@ MCP access is included with every plan, including the trial. No separate tier.
 ---
+## Privacy Policy
+Full policy: **<https://govconapi.com/privacy>**
+What this server does with your data, in short:
+- **Your API key** is read from `GOVCONAPI_KEY` in your own client's config and sent to `https://govconapi.com` in the `Authorization` header. This server process does not write it to disk or transmit it anywhere else.
+- **Your tool calls** become ordinary GovCon API requests. As with any request to the API, we log the timestamp, endpoint, query parameters, response status, response time and which key made the call, for billing, rate-limit enforcement and abuse detection. Usage logs are retained for 90 days.
+- **No conversation content leaves your machine.** Only the tool parameters your client fills in are sent, never the surrounding chat, and we log the status a request returned, not the contents of the response.
+- **We do not sell your data.**
+- **The data returned is public US federal procurement data** from SAM.gov, FPDS, USAspending, SBA DSBS and GSA CALC.
+---
 ## Links
 - API reference: <https://govconapi.com/api-guide>
 - Tool reference: <https://govconapi.com/mcp/tools>
+- Live coverage and freshness: <https://govconapi.com/api/v1/status>
 - Machine-readable docs: <https://govconapi.com/llms.txt> and <https://govconapi.com/openapi.json>
+- Privacy: <https://govconapi.com/privacy> · Terms: <https://govconapi.com/terms>
 - Support: <support@govconapi.com>
 MIT licensed. Data sourced from SAM.gov, FPDS, USAspending, SBA DSBS and GSA CALC, all public federal data.

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/README.md RENAMED Viewed

@@ -2,11 +2,13 @@
 # GovCon API MCP
-![MCP server](https://img.shields.io/badge/MCP-server-5865F2) ![53 tools](https://img.shields.io/badge/tools-53-1f6feb) ![corpus](https://img.shields.io/badge/corpus-10.8M_FPDS_transactions-1f6feb) [![from $19/mo](https://img.shields.io/badge/from-%2419%2Fmo-2ea44f)](https://govconapi.com/pricing)
+![MCP server](https://img.shields.io/badge/MCP-server-5865F2) ![53 tools](https://img.shields.io/badge/tools-53-1f6feb) ![5 federal sources](https://img.shields.io/badge/sources-5_federal-1f6feb) [![from $19/mo](https://img.shields.io/badge/from-%2419%2Fmo-2ea44f)](https://govconapi.com/pricing)
 **Most SAM.gov MCP servers wrap one dataset behind six to ten tools. This is 53 tools across five federal sources, already joined on the identifiers they share, including full text extracted from inside solicitation attachments.**
-US federal procurement data for agents: **668,576** SAM.gov opportunities, **10,787,941** FPDS prime contract transactions, **887,310** SAM-registered entities, **225,945** FFATA subawards, **164,322** exclusions, **13,778** decided GAO protests, and **~262,000** GSA CALC labor rates. Cross-linked on UEI, CAGE, PIID and NAICS, so one question does not become five integrations.
+US federal procurement data for agents: **668K** SAM.gov opportunities, **10.6M** FPDS prime contract transactions, **880K** SAM-registered entities, **226K** FFATA subawards, **164K** exclusions, **14K** decided GAO protests, and **~262K** GSA CALC labor rates. Cross-linked on UEI, CAGE, PIID and NAICS, so one question does not become five integrations.
+*Counts as of 2026-08-31, rounded. The corpus grows daily, so this file is a snapshot: current per-source totals and freshness dates are always live at [`/api/v1/status`](https://govconapi.com/api/v1/status), no key required.*
 > **Free 14-day trial, no credit card.** [Get a key](https://govconapi.com), then `pipx install govconapi-mcp`.
@@ -16,7 +18,7 @@ US federal procurement data for agents: **668,576** SAM.gov opportunities, **10,
 Most federal-contracting MCP servers are thin proxies over the official SAM.gov API. Four concrete differences.
-- **It searches inside the documents, not just the notice.** We extracted and indexed the full text of **506,382 documents** attached to **209,095 opportunities**, 31.4 billion characters, including **57,527 files recovered from archives nested up to five levels deep** that never appear in SAM's own attachment list, and **41,764 scanned documents recovered with OCR** (measured 2026-07-16). A requirement like CMMC, a clearance level, or an option year is usually in the SOW, not the notice. Most tools structurally cannot see it.
+- **It searches inside the documents, not just the notice.** We extract and index the full text of every document attached to a notice. A corpus study on **2026-07-16** measured **506,382 documents** across **209,095 opportunities**, 31.4 billion characters, including **57,527 files recovered from archives nested up to five levels deep** that never appear in SAM's own attachment list, and **41,764 scanned documents recovered with OCR**. Those five figures are one dated measurement and belong together; the index has grown since, and the running total is on [`/api/v1/status`](https://govconapi.com/api/v1/status). A requirement like CMMC, a clearance level, or an option year is usually in the SOW, not the notice. Most tools structurally cannot see it.
 - **Five sources, already joined.** SAM.gov opportunities and entities, FPDS contract transactions, USAspending/FFATA subawards, SAM exclusions, SBA DSBS certifications and GSA CALC rates, resolved onto shared identifiers. A wrapper hands your agent one dataset and leaves the joins to it.
 - **No SAM.gov entity registration and no company UEI required.** GSA documents 10 requests/day for a non-federal user without a SAM role, and 1,000/day with one. Access here is an email and a key.
 - **53 tools, organised by lifecycle stage.** Market research, opportunity discovery, capture and teaming, bid and negotiate, award and compliance. You should not have to know our URL structure to know which tool answers your question.
@@ -120,11 +122,27 @@ MCP access is included with every plan, including the trial. No separate tier.
 ---
+## Privacy Policy
+Full policy: **<https://govconapi.com/privacy>**
+What this server does with your data, in short:
+- **Your API key** is read from `GOVCONAPI_KEY` in your own client's config and sent to `https://govconapi.com` in the `Authorization` header. This server process does not write it to disk or transmit it anywhere else.
+- **Your tool calls** become ordinary GovCon API requests. As with any request to the API, we log the timestamp, endpoint, query parameters, response status, response time and which key made the call, for billing, rate-limit enforcement and abuse detection. Usage logs are retained for 90 days.
+- **No conversation content leaves your machine.** Only the tool parameters your client fills in are sent, never the surrounding chat, and we log the status a request returned, not the contents of the response.
+- **We do not sell your data.**
+- **The data returned is public US federal procurement data** from SAM.gov, FPDS, USAspending, SBA DSBS and GSA CALC.
+---
 ## Links
 - API reference: <https://govconapi.com/api-guide>
 - Tool reference: <https://govconapi.com/mcp/tools>
+- Live coverage and freshness: <https://govconapi.com/api/v1/status>
 - Machine-readable docs: <https://govconapi.com/llms.txt> and <https://govconapi.com/openapi.json>
+- Privacy: <https://govconapi.com/privacy> · Terms: <https://govconapi.com/terms>
 - Support: <support@govconapi.com>
 MIT licensed. Data sourced from SAM.gov, FPDS, USAspending, SBA DSBS and GSA CALC, all public federal data.

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/agencies.py RENAMED Viewed

@@ -6,9 +6,10 @@ import json
 import re
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
-@mcp.tool()
+@mcp.tool(title="Lookup Agency", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def lookup_agency(query: str) -> str:
     """Resolve an agency acronym or partial name to canonical SAM.gov agency strings.

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/award_compliance.py RENAMED Viewed

@@ -8,11 +8,12 @@ import json
 from typing import Optional
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
 # ─── Contracts (FPDS prime awards) ─────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search FPDS Contract Transactions", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_contracts(
     uei: Optional[str] = None,
     parent_uei: Optional[str] = None,
@@ -65,7 +66,7 @@ async def search_contracts(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Contract", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_contract(piid: str) -> str:
     """Get one contract's LATEST transaction plus a roll-up of obligation/value totals
     across every modification.
@@ -88,7 +89,7 @@ async def get_contract(piid: str) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Contract Modifications", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_contract_modifications(piid: str, limit: int = 100, offset: int = 0) -> str:
     """Get EVERY transaction row for a contract, oldest action first, the full
     modification trail (amendments, options exercised, partial terminations), not just
@@ -109,7 +110,7 @@ async def get_contract_modifications(piid: str, limit: int = 100, offset: int =
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get the Vehicle Behind a Contract", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_contract_vehicle(piid: str) -> str:
     """Get the contract vehicle (IDIQ, GWAC, FSS schedule, or BPA) this order was placed
     against.
@@ -130,7 +131,7 @@ async def get_contract_vehicle(piid: str) -> str:
 # ─── Vehicles (IDVs) ────────────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Vehicles", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_vehicles(
     uei: Optional[str] = None,
     parent_uei: Optional[str] = None,
@@ -175,7 +176,7 @@ async def search_vehicles(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Vehicle Detail", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_vehicle(piid: str) -> str:
     """Get one contract vehicle's detail: ceiling, period, and what's been ordered
     through it.
@@ -198,7 +199,7 @@ async def get_vehicle(piid: str) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Vehicle Holders", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_vehicle_holders(piid: str, limit: int = 50) -> str:
     """Get who holds a vehicle AND who's actually earning through it, two distinct
     populations, don't conflate them: a firm can hold a vehicle for years and earn
@@ -223,7 +224,7 @@ async def get_vehicle_holders(piid: str, limit: int = 50) -> str:
 # ─── Subawards (FFATA) ──────────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Subawards", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_subawards(
     prime_uei: Optional[str] = None,
     sub_uei: Optional[str] = None,
@@ -268,7 +269,7 @@ async def search_subawards(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Subaward", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_subaward(subaward_sam_report_id: str) -> str:
     """Get one FFATA subaward report by its SAM report ID.
@@ -280,7 +281,7 @@ async def get_subaward(subaward_sam_report_id: str) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Prime Subawards", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_prime_subawards(
     uei: str,
     date_from: Optional[str] = None,
@@ -307,7 +308,7 @@ async def get_prime_subawards(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Prime Relationships", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_prime_relationships(
     uei: str,
     date_from: Optional[str] = None,
@@ -333,7 +334,7 @@ async def get_prime_relationships(
 # ─── Bid Protests ────────────────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Protests", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_protests(
     outcome: Optional[str] = None,
     agency: Optional[str] = None,
@@ -374,7 +375,7 @@ async def search_protests(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Protests on a Solicitation", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_protests_on_solicitation(solicitation_number: str) -> str:
     """Get every protest filed on ONE solicitation, the contestability read for a
     specific opportunity or award: any protest pending right now, and the statutory date

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/awards.py RENAMED Viewed

@@ -13,9 +13,10 @@ import json
 from typing import Optional
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
-@mcp.tool()
+@mcp.tool(title="Search SAM Award Notices", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_awards(
     awardee: Optional[str] = None,
     uei: Optional[str] = None,

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/bid_negotiate.py RENAMED Viewed

@@ -8,11 +8,12 @@ import json
 from typing import Optional
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
 # ─── Contract Price Benchmarks ─────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Get Price Benchmark", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_price_benchmark(
     naics: str,
     set_aside: Optional[str] = None,
@@ -54,7 +55,7 @@ async def get_price_benchmark(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Price Position", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_price_position(
     naics: str,
     value: str,
@@ -94,7 +95,7 @@ async def get_price_position(
 # ─── Labor Rate Benchmarks ──────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Get Labor Rate Benchmark", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_labor_rate_benchmark(
     labor_category: str,
     match: str = "contains",
@@ -147,7 +148,7 @@ async def get_labor_rate_benchmark(
 # ─── Wage Determinations ────────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Wage Determinations", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_wage_determinations(
     type: Optional[str] = None,
     state: Optional[str] = None,
@@ -190,7 +191,7 @@ async def search_wage_determinations(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Wage Determinations by Location", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_wds_by_location(
     state: str, county: Optional[str] = None, type: Optional[str] = None,
     limit: int = 25, offset: int = 0,
@@ -216,7 +217,7 @@ async def get_wds_by_location(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Query Wage Rates Across Determinations", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_wage_rates(
     classification: Optional[str] = None,
     type: Optional[str] = None,
@@ -252,7 +253,7 @@ async def get_wage_rates(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Wage Rate Summary", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_wage_rate_summary(
     occupation_code: Optional[str] = None,
     classification: Optional[str] = None,
@@ -285,7 +286,7 @@ async def get_wage_rate_summary(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Wage Determination", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_wage_determination(wd_id: str) -> str:
     """Get one wage determination's full record: location array, every classification's
     hourly wage + fringe, and (for CBAs) the contractor/union detail block.
@@ -301,7 +302,7 @@ async def get_wage_determination(wd_id: str) -> str:
 # ─── Vendor Risk ─────────────────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Get Vendor Risk Report", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_vendor_risk_report(uei: str) -> str:
     """Get a 7-signal vendor risk report for one UEI, screening facts for teaming or
     subcontracting due diligence, before you commit to a partner.

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/capture_teaming.py RENAMED Viewed

@@ -8,11 +8,12 @@ import json
 from typing import Optional
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
 # ─── Companies (won at least one award) ───────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Companies", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_companies(
     q: Optional[str] = None,
     naics: Optional[str] = None,
@@ -51,7 +52,7 @@ async def search_companies(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Company Profile", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_company_profile(uei: str) -> str:
     """Get one company's aggregate profile: SAM registration (legal name, address, NAICS,
     PSC, certifications) combined with award-history totals.
@@ -72,7 +73,7 @@ async def get_company_profile(uei: str) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Company Awards", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_company_awards(
     uei: str,
     limit: int = 50,
@@ -100,7 +101,7 @@ async def get_company_awards(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Company Peers", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_company_peers(uei: str, limit: int = 10) -> str:
     """Find companies similar to this one by NAICS + agency overlap, the competitive
     landscape around a firm, not its own history.
@@ -121,7 +122,7 @@ async def get_company_peers(uei: str, limit: int = 10) -> str:
 # ─── Entities (the full SAM registry, award or not) ───────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Entities", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_entities(
     q: Optional[str] = None,
     naics: Optional[str] = None,
@@ -159,7 +160,7 @@ async def search_entities(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Expiring SAM Registrations", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_entities_expiring(
     within_days: int = 60,
     state: Optional[str] = None,
@@ -186,7 +187,7 @@ async def get_entities_expiring(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Entity", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_entity(uei: Optional[str] = None, cage_code: Optional[str] = None) -> str:
     """Get one SAM entity's full registration record by UEI or CAGE code, the same
     question, two different keys, so this is one tool, not two.
@@ -208,7 +209,7 @@ async def get_entity(uei: Optional[str] = None, cage_code: Optional[str] = None)
 # ─── Partners (teaming) ────────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Partners", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_partners(
     naics: Optional[str] = None,
     agency: Optional[str] = None,
@@ -247,7 +248,7 @@ async def search_partners(
 # ─── Company-contact resolver ──────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Get Company Decision-Maker Contact", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_company_contact(uei: str) -> str:
     """Resolve a vendor's REAL decision-maker contact, SAM registration agents
     (third-party filing services) are filtered out, so this is the actual point of
@@ -267,7 +268,7 @@ async def get_company_contact(uei: str) -> str:
 # ─── Contacts (buyer intel, contracting officers) ─────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Contracting Officer Contacts", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_contacts(
     name: Optional[str] = None,
     agency: Optional[str] = None,
@@ -293,7 +294,7 @@ async def search_contacts(
 # ─── Recompetes (also an early Capture signal; see Post-Award for the monitoring use) ──
-@mcp.tool()
+@mcp.tool(title="Search Recompetes", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_recompetes(
     naics: Optional[str] = None,
     agency: Optional[str] = None,
@@ -347,7 +348,7 @@ async def search_recompetes(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Recompete", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_recompete(piid: str) -> str:
     """Get one recompeting/expiring contract by PIID, plus incumbent-vulnerability
     signals (cert-lapse, lone-holder, single-agency dependence) composed from the

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/exclusions.py RENAMED Viewed

@@ -6,9 +6,10 @@ import json
 from typing import Optional
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
-@mcp.tool()
+@mcp.tool(title="Check Exclusions for a Vendor", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def check_exclusion(
     name: Optional[str] = None,
     uei: Optional[str] = None,

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/identifiers.py RENAMED Viewed

@@ -5,9 +5,10 @@ from __future__ import annotations
 import json
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
-@mcp.tool()
+@mcp.tool(title="Resolve DUNS to UEI", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def resolve_identifier(identifier: str) -> str:
     """Resolve between legacy DUNS (9 digits, or 13-digit DUNS+4) and current UEI
     (12 alphanumeric), accepts either side, returns both plus the entity name.

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/market_research.py RENAMED Viewed

@@ -7,11 +7,12 @@ import json
 from typing import Optional
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
 # ─── Contracting Offices ──────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Discover Offices", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def discover_offices(
     naics: str,
     sort: str = "biggest",
@@ -39,7 +40,7 @@ async def discover_offices(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Office Profile", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_office_profile(office_code: str) -> str:
     """Get one contracting office's full buying profile: obligations, competition,
     set-aside lean, and every NAICS it buys.
@@ -59,7 +60,7 @@ async def get_office_profile(office_code: str) -> str:
 # ─── Federal Hierarchy ────────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="List Organizations", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def list_organizations(
     type: Optional[str] = None,
     cgac: Optional[str] = None,
@@ -98,7 +99,7 @@ async def list_organizations(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Organization", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_organization(organization_id: int) -> str:
     """Get one federal organization's full record, with its parent, immediate children,
     and full ancestor chain (root department down to immediate parent) all included in
@@ -117,7 +118,7 @@ async def get_organization(organization_id: int) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Organization Relationships", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_org_relationships(organization_id: int, direction: str = "children") -> str:
     """Get JUST an organization's immediate children or its ancestor chain, without the
     rest of the record (get_organization already includes both if you need everything).
@@ -138,7 +139,7 @@ async def get_org_relationships(organization_id: int, direction: str = "children
 # ─── Procurement Forecasts ────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Search Forecasts", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_forecasts(
     source: Optional[str] = None,
     agency: Optional[str] = None,
@@ -193,7 +194,7 @@ async def search_forecasts(
 # ─── NAICS / Market Pulse ─────────────────────────────────────────────────
-@mcp.tool()
+@mcp.tool(title="Find NAICS Codes", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def find_naics_codes(
     sector: Optional[str] = None,
     prefix: Optional[str] = None,
@@ -236,7 +237,7 @@ async def find_naics_codes(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get NAICS Leaderboard", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_naics_leaderboard(board: str, limit: int = 30) -> str:
     """Browse curated, ranked NAICS market leaderboards, a fixed set of named rankings,
     distinct from find_naics_codes' open filtered search.
@@ -256,7 +257,7 @@ async def get_naics_leaderboard(board: str, limit: int = 30) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get NAICS Market", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_naics_market(code: str) -> str:
     """Get the federal market profile for one NAICS code: spending, competition,
     set-aside leverage, top buyers, and top incumbents.
@@ -278,7 +279,7 @@ async def get_naics_market(code: str) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get NAICS Positioning", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_naics_positioning(code: str) -> str:
     """Get the language and set-aside makeup for a NAICS code's SOLICITATION side: the
     phrase vocabulary contracting officers actually use in notices, the set-aside share
@@ -297,7 +298,7 @@ async def get_naics_positioning(code: str) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get NAICS Simplified-Acquisition Breakdown", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_naics_simplified_acquisition(code: str) -> str:
     """Get the award-value breakdown for a NAICS code over the last 12 months of FPDS
     prime awards: counts of micro / simplified-acquisition / above-SAT awards, and which
@@ -319,7 +320,7 @@ async def get_naics_simplified_acquisition(code: str) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get NAICS Competition", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_naics_competition(code: str) -> str:
     """Get how contested a NAICS market is, over the whole FPDS prime-award market: offers
     received per award, single-bidder share, top place-of-performance states, award-volume

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/govconapi_mcp/tools/opportunities.py RENAMED Viewed

@@ -5,9 +5,10 @@ import json
 from typing import Optional
 from ..core import mcp, _get
+from mcp.types import ToolAnnotations
-@mcp.tool()
+@mcp.tool(title="Search Opportunities", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def search_opportunities(
     naics: Optional[str] = None,
     psc: Optional[str] = None,
@@ -79,7 +80,7 @@ async def search_opportunities(
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Get Opportunity", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def get_opportunity(notice_id: str) -> str:
     """Fetch a single contract opportunity by its notice_id.
@@ -90,7 +91,7 @@ async def get_opportunity(notice_id: str) -> str:
     return json.dumps(data, indent=2, default=str)
-@mcp.tool()
+@mcp.tool(title="Recent Opportunity Changes", annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=True))
 async def recent_changes(
     since: str,
     limit: int = 100,

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 [project]
 name = "govconapi-mcp"
-version = "0.2.1"
+version = "0.2.2"
 description = "MCP server for GovCon API: 53 tools spanning the federal contracting lifecycle (market research, opportunity discovery, capture and teaming, bid and proposal, award and compliance) for Claude Desktop, Claude Code, Cursor, Zed, or any local MCP client."
 readme = "README.md"
 requires-python = ">=3.10"

{govconapi_mcp-0.2.1 → govconapi_mcp-0.2.2}/server.json RENAMED Viewed

@@ -2,17 +2,18 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.govconapi/govconapi",
   "title": "GovCon API",
-  "description": "US federal procurement data for agents: SAM.gov opportunities, FPDS contract awards, SAM entities, FFATA subawards, exclusions, and full-text search inside solicitation attachments.",
+  "description": "53 tools over US federal procurement: SAM.gov, FPDS awards, entities, subawards, exclusions.",
   "repository": {
     "url": "https://github.com/govconapi/govconapi-mcp",
     "source": "github"
   },
-  "version": "0.2.1",
+  "websiteUrl": "https://govconapi.com/mcp",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "govconapi-mcp",
-      "version": "0.2.1",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },