# XBRL US Filing Repository

Get XBRL data from US public companies and utilities by searching on facts, reports, entities, and tables or statements (cubes). Explore concepts, labels, references, roles, arcs, cubes, and assertio…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add marcward/xbrlus-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list marcward/xbrlus-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get marcward/xbrlus-mcp xbrl_searchEntities

# Call a tool
npx -y @smithery/cli@latest tool call marcward/xbrlus-mcp xbrl_searchEntities '{}'
```

## Direct MCP Connection

Endpoint: `https://xbrlus-mcp.run.tools`

**Required config:**
- `username` (header) — XBRL US Username
- `password` (header) — XBRL US password

## Tools (10)

- `xbrl_searchEntities` — Search for XBRL entities (companies) based on entity attributes such as CIK, name, or ticker.
- `xbrl_searchFacts` — Search for XBRL facts based on attributes of the fact, the report it was in, or the source of the data. Supports dot no…
- `xbrl_searchReports` — Search for XBRL reports based on report and entity attributes. Supports dot notation for all references.
- `xbrl_searchAssertions` — Search for XBRL assertion errors based on assertion, entity, and report attributes. Supports dot notation for all refer…
- `xbrl_searchDTS` — Search for XBRL discoverable taxonomy sets (DTS) based on taxonomy name, entry point, hash, version, or related report …
- `xbrl_searchConcepts` — Search for XBRL concepts in a specific DTS (discoverable taxonomy set) using dts.id and concept attributes. Supports do…
- `xbrl_searchLabels` — Search for XBRL label information associated with concepts in a DTS.
- `xbrl_searchReferences` — Search for XBRL reference information.
- `xbrl_searchCubes` — Search for XBRL cube (hypercube) information including dimensions, facts, and period attributes.
- `xbrl_searchDocuments` — Search for XBRL document information including taxonomy documents and filing documents.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get marcward/xbrlus-mcp <tool-name>
```