# XBRL US Filing Repository

XBRL US Filing Repository is an MCP server for Claude Code that searches XBRL records for US public companies and utilities, including entities, reports, facts, and taxonomies.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 117 installs
- Author: marcward
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/marcward/xbrlus-mcp
- Updated: 2026-02-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/xbrl-us-filing-repository

## What it does

The server gives an agent tools to find entities by CIK, name, or ticker, then search their facts and reports. Queries can also target assertion errors and document details. Fact and report searches accept attributes from related records.

Other tools cover discoverable taxonomy sets, concepts, labels, references, and cubes with dimensions and periods. That lets you inspect how filing data is organized. Its scope is US public companies and utilities, so it won’t serve searches for companies in other countries.

## Requirements
- Remote server: `https://xbrlus-mcp.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http xbrlus-mcp https://xbrlus-mcp.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add xbrl-us-filing-repository --url https://xbrlus-mcp.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xbrl-us-filing-repository": {
            "url": "https://xbrlus-mcp.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xbrl-us-filing-repository": {
            "type": "http",
            "url": "https://xbrlus-mcp.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http xbrl-us-filing-repository https://xbrlus-mcp.run.tools
```

## When to use it
- find company XBRL facts by report attributes
- locate reports for a specific entity
- check reports for XBRL assertion errors
- inspect concepts and taxonomy labels
- search cubes by dimensions and period

## Example prompts
- Find an XBRL entity by its ticker.
- Search this company’s reports and facts using the available attributes.
- Check this XBRL filing for assertion errors and find related documents.

## Similar
- [Axiora](https://affpapa.org/en/nevibecode/mcp/axiora.md) — MCP server · 129 installs
- [sec-edgar-mcp](https://affpapa.org/en/nevibecode/mcp/sec-edgar-mcp.md) — MCP server · ★ 388 repo stars
- [RoboSystems](https://affpapa.org/en/nevibecode/mcp/robosystems.md) — MCP server · ★ 32 repo stars
- [secedgar-mcp-server](https://affpapa.org/en/nevibecode/mcp/secedgar-mcp-server.md) — MCP server · ★ 12 repo stars
- [Canli Fundamentals](https://affpapa.org/en/nevibecode/mcp/canli-fundamentals.md) — MCP server · ★ 6 repo stars
- [Hub-Equity MCP](https://affpapa.org/en/nevibecode/mcp/hub-equity-mcp.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
