# api-evangelist/bargo-congress-trades-api architecture

> Architecture diagram of the GitHub repository api-evangelist/bargo-congress-trades-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/api-evangelist/bargo-congress-trades-api
- Repository: https://github.com/api-evangelist/bargo-congress-trades-api

## Overview

This repository is a third-party profile of Bargo’s Congress Trades API, not its implementation. It catalogs the REST and MCP surfaces and related machine-readable artifacts. The documented user workflow is to query trades, members, statistics, or health over REST, or use MCP tools; anonymous requests have lower quotas and a free API key raises limits. Disclosures are normalized from House and Senate reports into a dataset. No source excerpts were provided, so links below rely on README statements; internal artifact-to-artifact relationships are not inferred.

Main entry points: [`mcp/bargo-congress-trades-api-mcp.yml`](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/mcp/bargo-congress-trades-api-mcp.yml) (MCP Server), [`data-model/bargo-congress-trades-api-data-model.yml`](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/data-model/bargo-congress-trades-api-data-model.yml) (Trade Dataset), [`openapi/bargo-congress-trades-api-trades-api-openapi.yml`](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/openapi/bargo-congress-trades-api-trades-api-openapi.yml) (Trades API), [`openapi/bargo-congress-trades-api-members-api-openapi.yml`](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/openapi/bargo-congress-trades-api-members-api-openapi.yml) (Members API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["API Catalog"]
  node_catalog["API Listing<br/>[apis.yml]"]
end

subgraph group_rest["REST Surface"]
  node_trades["Trades API"]
  node_members["Members API"]
  node_statistics["Statistics API"]
  node_examples["Request Examples<br/>[_index.yml]"]
end

subgraph group_agents["Agent Access"]
  node_mcp["MCP Server"]
  node_tools["MCP Tools"]
  node_crosswalk["Tool Crosswalk"]
  node_skill["Agent Skill"]
end

subgraph group_domain["Data and Policy"]
  node_auth["Authentication"]
  node_data[("Trade Dataset")]
  node_limits["Rate Limits"]
  node_security["Domain Security"]
  node_attribution["Usage Terms"]
end

node_user(("API User"))
node_agent(("Agent Client"))
node_house["House Reports"]
node_senate["Senate Reports"]

node_user -->|"queries trades"| node_trades
node_user -->|"queries members"| node_members
node_user -->|"queries statistics"| node_statistics
node_agent -->|"calls tools"| node_mcp
node_mcp -->|"exposes tools"| node_tools
node_house -->|"reports feed"| node_data
node_senate -->|"reports feed"| node_data
node_user -->|"uses API key"| node_auth
node_user -->|"subject to quotas"| node_limits
node_agent -->|"uses guidance"| node_skill
node_user -->|"follows terms"| node_attribution

click node_catalog "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/apis.yml"
click node_trades "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/openapi/bargo-congress-trades-api-trades-api-openapi.yml"
click node_members "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/openapi/bargo-congress-trades-api-members-api-openapi.yml"
click node_statistics "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/openapi/bargo-congress-trades-api-statistics-api-openapi.yml"
click node_examples "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/examples/_index.yml"
click node_mcp "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/mcp/bargo-congress-trades-api-mcp.yml"
click node_tools "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/mcp/bargo-congress-trades-api-tools-list.json"
click node_crosswalk "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/mcp/bargo-congress-trades-api-tool-crosswalk.yml"
click node_skill "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/skills/bargo-congress-api.md"
click node_auth "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/authentication/bargo-congress-trades-api-authentication.yml"
click node_data "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/data-model/bargo-congress-trades-api-data-model.yml"
click node_limits "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/rate-limits/bargo-congress-trades-api-rate-limits.yml"
click node_security "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/security/bargo-congress-trades-api-domain-security.yml"
click node_attribution "https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/conventions/bargo-congress-trades-api-conventions.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_catalog,node_user,node_agent toneBlue
class node_trades,node_members,node_statistics,node_examples toneAmber
class node_mcp,node_tools,node_crosswalk,node_skill toneMint
class node_auth,node_data,node_limits,node_security,node_attribution toneRose
class node_house,node_senate toneIndigo
```

## Components

### API Catalog

- [API Listing](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/apis.yml): `apis.yml`

### REST Surface

- [Trades API](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/openapi/bargo-congress-trades-api-trades-api-openapi.yml): `openapi/bargo-congress-trades-api-trades-api-openapi.yml`
- [Members API](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/openapi/bargo-congress-trades-api-members-api-openapi.yml): `openapi/bargo-congress-trades-api-members-api-openapi.yml`
- [Statistics API](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/openapi/bargo-congress-trades-api-statistics-api-openapi.yml): `openapi/bargo-congress-trades-api-statistics-api-openapi.yml`
- [Request Examples](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/examples/_index.yml): `examples/_index.yml`

### Agent Access

- [MCP Server](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/mcp/bargo-congress-trades-api-mcp.yml): `mcp/bargo-congress-trades-api-mcp.yml`
- [MCP Tools](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/mcp/bargo-congress-trades-api-tools-list.json): `mcp/bargo-congress-trades-api-tools-list.json`
- [Tool Crosswalk](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/mcp/bargo-congress-trades-api-tool-crosswalk.yml): `mcp/bargo-congress-trades-api-tool-crosswalk.yml`
- [Agent Skill](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/skills/bargo-congress-api.md): `skills/bargo-congress-api.md`

### Data and Policy

- [Authentication](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/authentication/bargo-congress-trades-api-authentication.yml): `authentication/bargo-congress-trades-api-authentication.yml`
- [Trade Dataset](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/data-model/bargo-congress-trades-api-data-model.yml): `data-model/bargo-congress-trades-api-data-model.yml`
- [Rate Limits](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/rate-limits/bargo-congress-trades-api-rate-limits.yml): `rate-limits/bargo-congress-trades-api-rate-limits.yml`
- [Domain Security](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/security/bargo-congress-trades-api-domain-security.yml): `security/bargo-congress-trades-api-domain-security.yml`
- [Usage Terms](https://github.com/api-evangelist/bargo-congress-trades-api/blob/main/conventions/bargo-congress-trades-api-conventions.yml): `conventions/bargo-congress-trades-api-conventions.yml`

### Other components

- **API User**
- **Agent Client**
- **House Reports**
- **Senate Reports**

## Connections

- API User → Trades API: queries trades (evidence: `README.md`)
- API User → Members API: queries members (evidence: `README.md`)
- API User → Statistics API: queries statistics (evidence: `README.md`)
- Agent Client → MCP Server: calls tools (evidence: `README.md`)
- MCP Server → MCP Tools: exposes tools (evidence: `README.md`)
- House Reports → Trade Dataset: reports feed (evidence: `README.md`)
- Senate Reports → Trade Dataset: reports feed (evidence: `README.md`)
- API User → Authentication: uses API key (evidence: `README.md`)
- API User → Rate Limits: subject to quotas (evidence: `README.md`)
- Agent Client → Agent Skill: uses guidance (evidence: `README.md`)
- API User → Usage Terms: follows terms (evidence: `README.md`)
