# SEC XBRL MCP for AI Agents AI Agent Connect

> SEC XBRL (Financial Reporting) lets you pull real-time SEC EDGAR financial data directly into your AI agent. Query filing histories, company facts, and XBRL disclosures without manual searching or scraping.

## Overview
- **Category:** data-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cLng9A0W6ltfBxMgVVobNLbFRjl9lTzK9evhJdEW/ai-agent-connect
- **Tags:** xbrl, financial-reporting, sec-edgar, data-retrieval, compliance, public-records

## Description

Stop wasting hours digging through the SEC EDGAR database or trying to scrape messy financial statements into a spreadsheet. This Connector connects your AI agent directly to the official public filing infrastructure, giving you a clean way to pull standardized XBRL data. Instead of hunting for specific numbers, you can just ask your agent to find a company's history or pull specific financial concepts like net income over several years. It turns the SEC's massive data dump into a searchable, queryable source of truth. When you add this to your toolkit via the Vinkius catalog, you're not just getting a data feed; you're getting a way to do deep financial analysis in seconds. You can grab a dictionary of facts for a specific company or aggregate data points across an entire industry to see how everyone's reporting looks for a certain quarter. It's about moving from manual data entry to actual analysis.

## Tools

### get_company_concept
Get all XBRL disclosures for a single company concept. This is useful for tracking specific metrics over time.

### get_company_facts
Get all company concepts data for a specific company. Use this to see every reported fact in one go.

### get_submissions
Get filing history for a specific entity. This pulls the metadata and recent filings for any CIK.

### get_xbrl_frames
Get aggregated facts for a specific concept and period. This allows for market-wide data comparisons.

## Prompt Examples

**Prompt:** 
```
What did Microsoft report for net income in their last filing?
```

**Response:** 
```
I've pulled the latest XBRL data for Microsoft. In their most recent filing:

* **Net Income:** $88.1B
* **Reporting Period:** Q3 2024
* **Standard:** US-GAAP

Would you like me to pull this for other companies to see how they compare?
```

**Prompt:** 
```
Give me a list of all filings for CIK 789019.
```

**Response:** 
```
I've retrieved the submission history for CIK 789019. Here are the most recent entries:

| Date | Form Type | Description |
| :--- | :--- | :--- |
| 2024-05-10 | 10-K | Annual Report |
| 2024-02-15 | 8-K | Current Report |
| 2024-01-20 | 10-Q | Quarterly Report |

Let me know if you'd like to see the details for a specific one.
```

**Prompt:** 
```
Compare the current assets of all companies in USD for Q3 2023.
```

**Response:** 
```
I'm aggregating the XBRL frames for Current Assets for the Q3 2023 period. 

Here are some of the top results:
* **Company A:** $52.4B
* **Company B:** $12.1B
* **Company C:** $8.9B

I have the full list ready. Would you like me to export this as a summary table?
```

## Capabilities

### Pull full submission histories
Get every filing and metadata entry for a specific entity using its CIK.

### Fetch all XBRL facts
Retrieve the entire dictionary of reported facts for a specific company.

### Extract specific financial concepts
Drill down into metrics like assets or revenue for a single company over time.

### Aggregate market-wide data
Pull specific financial data points across all reporting entities for a period.

### Verify disclosure accuracy
Check submission histories and disclosure details to ensure compliance.

## Use Cases

### Comparing debt across a sector
An analyst needs to see the debt of 50 different companies. They ask the agent to use get_xbrl_frames to pull those specific metrics for Q3.

### Verifying a company's filing history
A compliance officer needs to check if a company has missed any filings. They use get_submissions to pull the full history for a CIK.

### Tracking net income trends
An investor wants to see how a company's net income has changed over 5 years. The agent uses get_company_concept to pull the data.

### Onboarding a new stock for research
A researcher wants to see everything a company has reported. They use get_company_facts to pull the entire XBRL dictionary.

## Benefits

- No more manual data entry: Use get_company_facts to pull data directly into your workflow instead of copying from websites.
- Faster industry comparisons: Use get_xbrl_frames to see how all companies in a sector compare in a single request.
- Accurate history tracking: Get every filing for a CIK using get_submissions to see the full submission timeline.
- Precise concept drilling: Use get_company_concept to track specific metrics like assets or liabilities over time.
- Standardized data: Pull US-GAAP and IFRS data in a consistent format every time you query a company.
- Reduced research time: Let your agent handle the search while you focus on the actual financial modeling.

## How It Works

The bottom line is you get direct, programmatic access to SEC financial disclosures without the manual overhead.

1. Subscribe to the Connector and grab your SEC User-Agent string.
2. Connect the Connector to your AI client like Claude or Cursor.
3. Ask your agent to pull SEC filings or specific financial facts.

## Frequently Asked Questions

**Can the SEC XBRL MCP pull data for international companies?**
Yes, the Connector can access data for any entity that files with the SEC, including many international companies that report in the U.S. market.

**Do I need a special account to use the SEC XBRL MCP?**
You do not need a special account. You only need to provide your SEC User-Agent string, which is a standard requirement for accessing their public data.

**How does the SEC XBRL MCP handle different accounting standards?**
The Connector handles multiple taxonomies, including US-GAAP and IFRS, allowing you to pull standardized facts regardless of the specific reporting standard used.

**Can I use the SEC XBRL MCP to find specific 8-K filings?**
Yes, the Connector can retrieve the submission history for any CIK, which includes 8-K, 10-K, and 10-Q filings.

**Is the data from the SEC XBRL MCP updated in real time?**
The Connector pulls from the SEC's public filing infrastructure, so it reflects the most recent data made available by the commission.

**How do I find the filing history for a specific company?**
Use the `get_submissions` tool with the company's Central Index Key (CIK). For example, Apple is 320193. The tool automatically handles leading zeros.

**Can I retrieve specific financial metrics like 'Net Income' for a company?**
Yes. Use `get_company_concept` by providing the CIK, the taxonomy (usually 'us-gaap'), and the XBRL tag (like 'NetIncomeLoss').

**How can I compare a single metric across all companies for a specific year?**
Use the `get_xbrl_frames` tool. You can specify a concept, unit, and period (e.g., 'CY2023') to get data for every reporting entity in that timeframe.