# Oravan (remote · oravan.org)

Nonpartisan U.S. Congress data: bill decodes, rep lookup, bilingual EN/ES, read-only, no accounts.

- Trust score: 68/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `oravan.org`: 68/100 (this document), [markdown](https://verifymcp.io/servers/org-oravan-mcp/api-mcp-mcp.md), [page](https://verifymcp.io/servers/org-oravan-mcp/api-mcp-mcp)

## Channel facts

- Endpoint: `https://oravan.org/api/mcp/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 5 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 68/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 866 tokens (~173/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http org-oravan-mcp https://oravan.org/api/mcp/mcp
```

### Codex

```toml
[mcp_servers.org-oravan-mcp]
url = "https://oravan.org/api/mcp/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "org-oravan-mcp": {
      "type": "remote",
      "url": "https://oravan.org/api/mcp/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add org-oravan-mcp --url https://oravan.org/api/mcp/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  org-oravan-mcp:
    url: "https://oravan.org/api/mcp/mcp"
```

### Other

```json
{
  "mcpServers": {
    "org-oravan-mcp": {
      "type": "http",
      "url": "https://oravan.org/api/mcp/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 66, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 65, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 63, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 63)

First indexed and scored.

## MCP tools (5)

### `lookup_representatives` (~208 tokens)

Look up representatives by ZIP

Look up a person's U.S. House member and two Senators by 5-digit ZIP code. Returns each member's name, party, phone, official website, portrait URL, and district office phone numbers - the number a constituent should actually call. Some ZIP codes span more than one congressional district (needs_address: true, all candidate districts returned); this tool does not perform address-level refinement itself in this release - point the person to the response's reps_url, where a stateless, unlogged Census-geocoder proxy narrows it to a single district from a street address that Oravan never stores. When a House seat currently has no member, `vacancies` lists the empty seat(s) (state + district) explicitly - the departed member is never returned as if still serving, and no election timeline is implied.

Input parameters:

- `locale` (string): Response language: "en" (default) or "es".
- `zip` (string, required): 5-digit U.S. ZIP code.

### `get_bill` (~232 tokens)

Get a bill decode

Get the full plain-language decode of a federal bill by slug (e.g. "hr-2701-119") or citation (e.g. "H.R. 2701" - resolves to the most recent Congress on a match). Returns the AI-generated summary (headline, tl;dr, what/who/why/cost - human-reviewed before publish and clearly labeled when present), the official status in plain language, an urgency band, sponsor, key dates, the official Congress.gov page, and an act_url to Oravan's on-site call flow. This tool never drafts a phone script - script generation only happens on-site, behind a human-review step, never over this API.

Input parameters:

- `citation` (string): Bill citation, e.g. "H.R. 2701" or "S.J.Res. 99". Used only when slug is omitted.
- `locale` (string): Response language: "en" (default) or "es".
- `slug` (string): Bill slug, e.g. "hr-2701-119". Takes priority over citation when both are given.

### `search_bills` (~150 tokens)

Search bills

Search Oravan's bilingual federal bill corpus by free-text query, issue topic, status, or active-only. Returns short teasers (headline, status, urgency) for matching bills, most urgent first.

Input parameters:

- `active_only` (boolean): Exclude signed/vetoed (terminal) bills when true.
- `limit` (integer): Max results (default 20, max 50).
- `locale` (string): Response language: "en" (default) or "es".
- `query` (string): Free-text search over the bill title and plain-language summary.
- `status` (string): Bill status to filter to.
- `topic` (string): One of the 12 issue categories.

### `whats_moving` (~181 tokens)

What's moving in Congress

What's moving in Congress recently: active, plain-language-decoded bills that cleared Oravan's 'act now' urgency bar within the last N days (default 7), optionally filtered by topic. Returns an honest empty list with quiet_week: true when nothing has cleared the bar - this tool never pads the list to look busier than Congress actually is this week. If the list is empty because Oravan's own data sync looks stale rather than Congress being quiet, data_stale is set instead so that distinction is never lost.

Input parameters:

- `days` (integer): Lookback window in days (default 7).
- `limit` (integer): Max results (default 10, max 50).
- `locale` (string): Response language: "en" (default) or "es".
- `topic` (string): One of the 12 issue categories.

### `get_representative` (~95 tokens)

Get a representative

Get full details for one member of Congress by bioguide ID (e.g. "W000797"), plus their 5 most recently active sponsored bills. Facts only: no scorecards, ratings, or vote grades.

Input parameters:

- `bioguide` (string, required): Bioguide ID, e.g. "W000797".
- `locale` (string): Response language: "en" (default) or "es".

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/org-oravan-mcp/api-mcp-mcp#diagnostics

## Score history

- 2026-08-03: 68
- 2026-08-02: 67
- 2026-08-01: 67
- 2026-07-31: 66
- 2026-07-30: 65
- 2026-07-29: 65
- 2026-07-28: 64
- 2026-07-27: 63
- 2026-07-26: 63

## Links

- Remote endpoint: https://oravan.org/api/mcp/mcp
- Repository: https://github.com/cm2489/oravan
- Website: https://oravan.org/mcp
- Changelog RSS feed: https://verifymcp.io/servers/org-oravan-mcp/api-mcp-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/org-oravan-mcp/api-mcp-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/org-oravan-mcp/api-mcp-mcp