mcp/pia pulls statistics

Program Integrity Alliance MCP Server

An MCP server to help make U.S. Government open datasets AI-friendly.

What is an MCP Server?

MCP Info

Attribute|Details| |-|-| Docker Image|mcp/pia Author|Program-Integrity-Alliance Repository|https://github.com/Program-Integrity-Alliance/pia-mcp-local

Image Building Info

Attribute|Details| |-|-| Dockerfile|https://github.com/Program-Integrity-Alliance/pia-mcp-local/blob/f10cab6874a341c79aedbcba9bab6df7e1313069/Dockerfile Commit|f10cab6874a341c79aedbcba9bab6df7e1313069 Docker Image built by|Docker Inc. Docker Scout Health Score| Verify Signature|COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/pia --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub Licence|MIT License

Available Tools (2)

Tools provided by this Server|Short Description -|- pia_oversight_recommendations|Search oversight recommendations (Open Recommendations dataset) with facets enabled by default.| pia_search|Search the Program Integrity Alliance (PIA) database of government oversight reports, recommendations, executive orders, legislation, and integrity data (GAO, OIG/Oversight.gov, CRS, DOJ, Congress.gov, Federal Register).|

Tools Details

Tool: pia_oversight_recommendations

Search oversight recommendations (Open Recommendations dataset) with facets enabled by default. Today's date is 2026-06-25. This dataset contains recommendations from GAO and Oversight.gov only — SourceDocumentDataSource filters for any other source will be ignored. Do NOT filter by SourceDocumentDataSet — this tool already targets the 'Open Recommendations' dataset automatically. IMPORTANT: When a text query is provided, do NOT add a referenced_agencies filter — the query handles relevance matching. Only use referenced_agencies when the query is empty (pure filter/facet lookups). total_count is the number of OPEN recommendations matching the query and all applied filters — report it as that count. The results are a representative sample to summarize, and facets break the set down by status, priority, agency, and theme. Counts from free-text queries are approximate (semantic matching); pure filter or agency lookups are exact. Recommendations have no per-document citations, so it is very important to always include the govquery_url for the full set in Rec Spotlight rather than citing individual rows. Parameters|Type|Description -|-|- query|string|Search query text facets_only|boolean *optional*|Return ONLY the facet breakdown + total_count + Rec Spotlight govquery_url, omitting the individual recommendation rows — to see the open-rec population broken down by status/priority/agency/theme without pulling rows. filter|string *optional*|Optional OData filter expression supporting complex boolean logic.

AVAILABLE FIELDS: • SourceDocumentDataSource: Data source/agency that published the document. Major sources (>1k documents): 'Department of Justice', 'Congress.gov', 'Oversight.gov', 'CRS', 'GAO', 'Federal Register' • SourceDocumentDataSet: Dataset or collection the document belongs to. Values include: 'reports', 'federal-reports', 'press-releases', 'executive orders', 'Open Recommendations'. Note: the value is 'Open Recommendations' (not 'recommendations'). Values: 'press-releases', 'bills-and-laws', 'reports', 'federal-reports', 'executive orders', 'state-and-local-reports', 'annual-financial-reports', 'congressional-justification-reports', 'performance-and-accountability-reports' • SourceDocumentTitle: Document title - use contains, eq for text matching • SourceDocumentPublishDate: Publication date - ISO 8601 format YYYY-MM-DD (e.g., '2023-01-01'). Use ge/le for ranges • RecStatus: Recommendation status • RecPriorityFlag: Priority flag for recommendations • SourceDocumentIsRecDoc: Whether the document contains recommendations. Values: 'No', 'Yes' • RecFraudRiskManagementThemePIA: Fraud risk management theme classification • RecMatterForCongressPIA: Whether the matter is for Congressional attention • RecRecommendation: Recommendation text - use contains, eq for text matching • RecAgencyComments: Agency comments on recommendations - use contains, eq for text matching • referenced_agencies: Agencies referenced by documents (collection field). IMPORTANT: Only use this filter when the query is empty (pure filter/facet lookups). Do NOT combine with a text query — the query already handles relevance matching. Example: (referenced_agencies/any(a: a eq 'Department of Defense (DOD)') or referenced_agencies/any(a: a eq 'Department of Justice (DOJ)')) - for single agency omit outer parentheses and 'or'. Get all values via pia_search with facets_only=true.

OPERATORS: • Text: contains, eq, ne, startswith, endswith • Exact: eq (equals), ne (not equals), in (in list) • Date: ge (greater/equal), le (less/equal), eq (equals) • Logic: and, or, not, parentheses for grouping

EXAMPLES: • "SourceDocumentDataSource eq 'GAO'" • "SourceDocumentDataSource eq 'GAO' and RecStatus ne 'Closed'" • "(SourceDocumentDataSource eq 'GAO' or SourceDocumentDataSource eq 'OIG') and RecStatus eq 'Open'" • "SourceDocumentPublishDate ge '2020-01-01' and SourceDocumentPublishDate le '2024-12-31'"

TIP: Use pia_search with facets_only=true to get the most current available values.…

Description from the Docker Hub listing.