FOIA.gov MCP for AI. Access structured US government records.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
FOIA.gov provides direct access to US government transparency data via Freedom of Information Act records. Use this MCP to discover agency components, pull detailed metadata for specific departments, generate compliance forms, and retrieve annual reports in structured XML format.
It lets your AI client interact with the complex structure of federal agencies using natural conversation.
What your AI can do
Get agency component request form
Fetches the precise structure and required fields for a FOIA request form specific to one component.
Get agency component
Retrieves deep metadata for a specific component using its unique UUID.
Get annual report xml
Downloads the official annual report data for an agency in structured XML format, based on the year provided.
List and filter every component within the FOIA system by title or abbreviation.
Fetch deep metadata for a known agency part using its unique identification code (UUID).
Pull the exact required fields and format needed to build an official FOIA submission for any component.
Download agency transparency metrics from yearly reports in XML format, ready for data processing.
Ask an AI about this
Waiting for input…
FOIA.gov (Freedom of Information) 4 Tools
Use these four tools to systematically gather US government records, component details, and compliance data straight from the source.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using FOIA.gov (Freedom of Information) on VinkiusGet Agency Component Request Form
Fetches the precise structure and required fields for a FOIA request form specific to one component.
Get Agency Component
Retrieves deep metadata for a specific component using its unique UUID.
Get Annual Report Xml
Downloads the official annual report data for an agency in structured XML format...
List Agency Components
Lists all available FOIA agency components, letting you filter the search results by...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with FOIA.gov (Freedom of Information), then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by FOIA.gov. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 4 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Getting Public Records Used To Be a Crawl Through Bureaucracy
Right now, getting official data means navigating massive, siloed websites. You gotta click through dozens of directory pages, download PDFs that require manual reading, and constantly cross-reference different agency sub-sections just to find out what you're looking for.
With this MCP, the process flips. Instead of endless clicks, your agent talks directly to the structured records. It pulls clean component lists or required forms in a format you can actually use, giving you immediate access to actionable data.
Get Agency Component Details and Forms with `get_agency_component`
Today, finding out if an agency component handles a specific type of record requires guessing its UUID or manually reading deep documentation. You're left asking: 'Am I looking at the right place?'
Now, you tell your agent to use `get_agency_component` with the ID. It immediately delivers all the metadata and confirms exactly what that component is responsible for. The guesswork is gone.
What your AI can actually do with this
This connector helps you cut through the bureaucracy of US government data. Instead of spending hours navigating massive websites, figuring out which department holds what records, or manually downloading incompatible PDFs, you can talk to your agent and get precise data structures back.
It lets you list all the components of a federal agency—from the Department of Justice down to specific sub-sections. Need to know exactly what fields are required to submit a request for one component? It fetches that official form structure instantly. You can also pull historical metrics, like annual reports in XML format, which is gold for large data analysis.
If you're building an automated research pipeline, Vinkius makes sure this MCP is accessible from your favorite AI client, giving you structured government records without the friction.
019e389a-231e-70ec-b209-13919891e48d Here's how it actually works
The bottom line is: you skip the website navigation and get directly to actionable government data.
First, connect your AI client to this MCP and provide the required FOIA.gov API key.
Tell your agent what you need—for example, 'List all components under DHS' or 'Get the 2021 annual report for DOJ'.
The MCP executes the request and sends back clean, structured data (JSON or XML) that your agent can use immediately.
Who is this actually for?
Journalists, legal researchers, and data analysts who spend time wrestling with complex public records. If your job involves tracking governmental transparency or proving regulatory compliance, this MCP saves hours of manual digging.
Needs to quickly identify which agency components handle specific types of records and pull historical annual report data in XML format for a story.
Must automate the retrieval of request form structures to ensure any client submission meets the exact, current requirements for a given federal component.
Pulls large-scale transparency data by fetching annual report XMLs across multiple agencies for comparative analysis.
What Changes When You Connect
Stop guessing the right web page. Use list_agency_components to quickly see every component that handles public records, letting you narrow down your search immediately.
Avoid compliance errors. If you need to file a request, use get_agency_component_request_form. It gives you the exact required JSON schema for that specific agency part.
Analyze large datasets fast. Pulling annual reports via get_annual_report_xml provides raw XML metrics, which is much better than wading through image-heavy PDFs.
Pinpoint missing data points. Need to know exactly what a department does? Run the component details using get_agency_component for full metadata on any UUID.
Saves research time. Instead of opening 20 different government websites, you ask your agent and get structured answers from one place.
See it in action
Investigating a specific department's mandate
A researcher needs to know if the National Weather Service (NWS) falls under the Department of Commerce. Instead of clicking through confusing directory pages, they ask their agent to list_agency_components and filter by 'weather.' The system instantly returns the component details for NWS.
Building a compliant form generator
A legal team needs to build an internal tool that accepts FOIA requests. They use get_agency_component_request_form on a target component UUID, which returns the JSON schema needed for their submission validation layer.
Comparing departmental spending over time
A data analyst wants to compare Department A's transparency metrics against Department B's from 2019-2023. They use get_annual_report_xml repeatedly for each department and year, getting clean XML files ready for a single spreadsheet import.
Mapping an unknown agency UUID
A journalist has found a strange component UUID in a public document but doesn't know what it belongs to. They feed the ID into get_agency_component, and the system returns all the associated metadata, including its parent department.
The honest tradeoffs
Treating it like a general search engine
Asking the agent simply to 'Find records on climate change.' This is too vague. The system can't guess which specific component or year you mean, so it fails.
First, use list_agency_components to narrow down the department (e.g., EPA). Then, specify your goal using a tool like get_annual_report_xml for that precise agency and year.
Confusing components with reports
Thinking you can get an annual report just by listing the component. You'll only get basic metadata, not the actual historical data.
You need two steps: use get_agency_component to identify the agency UUID first. Then, run get_annual_report_xml, providing that UUID and the year.
Building a form without validation
Trying to write code that submits a FOIA request using just assumed fields. You'll miss required metadata or fail compliance checks.
Always use get_agency_component_request_form first. It gives you the authoritative, current JSON schema for submission.
When It Fits, When It Doesn't
Use this MCP if your goal is to extract structured data directly from US government transparency records (annual reports, official request forms, component metadata). You must use it when compliance or historical record retrieval is mandatory. Don't use it if you just need general contact information—a standard directory API might be better. Also, don't rely on it for real-time, non-documented internal memos; the data source is public and structured. If your task requires querying a niche database not linked to FOIA.gov (like HR records), this MCP won't help. Stick to its core function: government record metadata.
Questions you might have
How do I find out which agency components are available using list_agency_components? +
You just tell your agent to run list_agency_components. It sends you a filtered, structured list of every component. You can then filter that output by title or abbreviation right away.
What is the difference between get_agency_component and getting annual report XML? +
These two tools serve different purposes. get_agency_component gives you metadata (details about the component itself). get_annual_report_xml gives you actual historical data metrics for that agency over time.
Do I need a UUID to use get_agency_component_request_form? +
Yes, you do. The form structure is specific to one component. You must provide the component's unique identifier (UUID) so the tool can fetch the correct compliance fields.
Can I pull annual report XML for multiple years at once? +
The get_annual_report_xml tool fetches reports year by year. You'll need to run it sequentially, providing the specific UUID and each target year.
What happens if I run `list_agency_components` without proper authentication? +
The call fails immediately with an API key error. You must first ensure your agent is configured with a valid FOIA.gov API key within the Vinkius catalog before running any tool.
If I use `get_agency_component` but provide an invalid UUID, what error do I receive? +
You get a standard 404 Not Found status. The response body will confirm that the component ID does not exist in the registry, helping you correct your input quickly.
Does `list_agency_components` support filtering or pagination for large result sets? +
Yes, the tool supports JSON API sparse fieldsets and inclusion parameters. You can pass these directly in your query to narrow results or handle thousands of records efficiently.
When using `get_agency_component_request_form`, what format is the returned schema? +
It returns a structured JSON schema. This output details all required fields and their expected data types, making it easy for your agent to build compliance-ready submissions.
How can I find the specific requirements for filing a FOIA request with an agency? +
You can use the get_agency_component_request_form tool with the agency's UUID. It will return the full structure of the form, including all required fields and instructions.
Is it possible to list all sub-components of a major government agency? +
Yes. Use list_agency_components and you can include the parent agency information to filter or identify all components belonging to a specific department.
Can I access the raw annual transparency reports for data analysis? +
Absolutely. The get_annual_report_xml tool allows you to fetch the official NIEM-standard XML reports for any agency and year (e.g., DOJ, 2021).
We've already built the connector for FOIA.gov. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 4 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.