Skip to main content

Acquisition.gov MCP

Read-only, deterministic MCP access to the official Acquisition.gov FAR Overhaul (RFO) model-part pages, the posted agency-deviation index, official deviation PDFs, and a small allowlist of RFO guidance resources.

This server reports source content and metadata. It does not decide which rule governs a procurement. In particular, model deviation text is not treated as operative for an agency without that agency's posted deviation.

Install

uvx acquisition-gov-mcp==1.0.0

The server uses stdio, requires no credentials, and defaults to a three-second cross-process interval between Acquisition.gov requests. FEDERAL_API_MIN_INTERVAL_SECONDS may increase or decrease that interval for controlled testing; production clients should retain three seconds.

Tools

Tool Purpose
list_rfo_parts(part?, agency?, updated_since?) List RFO model parts with official source dates and matching posted-deviation counts.
get_rfo_part(part, section?, cursor?, max_characters?) Retrieve parsed, paginated model text for one FAR part.
list_rfo_agency_deviations(agency?, part?, limit?) Discover posted deviation documents. At least one filter is required.
get_rfo_agency_deviation(source_id, page_start?, page_end?) Resolve only an indexed source ID and return page-numbered PDF text and document-found applicability language.
get_rfo_guidance(resource, heading?, cursor?) Retrieve the FAQ, policy-and-guidance page, or FAR Council deviation-guidance PDF.

Every retrieved source includes a canonical URL, UTC retrieval time, SHA-256 content hash, extraction status, and warnings. Agency PDF dates and applicability are returned only when labeled language is found inside the document; filenames are never used to infer them.

Safety boundary

  • Only https://acquisition.gov and https://www.acquisition.gov are allowed.
  • Redirect targets are revalidated; credentials, explicit ports, arbitrary hosts, and private IP targets are rejected.
  • Responses are limited by content type, bytes, redirects, pages, and output length.
  • HTTP 429 is not burst-retried. Retry-After is retained in the shared pacing state.
  • If the Python TLS transport stalls against Acquisition.gov's CDN, the server may use an installed system curl for the same prevalidated URL; redirects remain disabled and revalidated by the server.
  • Duplicate and conflicting index entries are returned with warnings instead of silently resolved.
  • Scanned, encrypted, and malformed PDFs return explicit extraction status and metadata where possible.

See testing.md for the release evidence and live-gate instructions.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

acquisition_gov_mcp-1.0.0.tar.gz (111.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

acquisition_gov_mcp-1.0.0-py3-none-any.whl (15.3 kB view details)

Uploaded Python 3

File details

Details for the file acquisition_gov_mcp-1.0.0.tar.gz.

File metadata

  • Download URL: acquisition_gov_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 111.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for acquisition_gov_mcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 0c6cfb108e85b52b3d6b3a369f8c475a5b56ffe628fd5506335147a9c8190e9e
MD5 f24ca1f0100504e8e741af42966eb265
BLAKE2b-256 5cc48221e82a28ad3a1f470e6783840de43cddd3c7704e8a10eba6334348a3a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for acquisition_gov_mcp-1.0.0.tar.gz:

Publisher: publish-pypi.yml on 1102tools-dev/federal-contracting-mcps

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file acquisition_gov_mcp-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for acquisition_gov_mcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 842a184e9efee1400ccac87323bb108fbb069df4cc3a7516753162d5e35bec88
MD5 181aa38076bf1b0f212f75905eb4257c
BLAKE2b-256 56f1863dc4c7d624fcf999480f132155bad5713be301d568e6868bb291ef4587

See more details on using hashes here.

Provenance

The following attestation bundles were made for acquisition_gov_mcp-1.0.0-py3-none-any.whl:

Publisher: publish-pypi.yml on 1102tools-dev/federal-contracting-mcps

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.0.2

2 files

1.0.1

2 files

This release

1.0.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page