capitolguide

Pre-flight readiness check. Run before any other tool. Verifies secrets, KV, DB connectivity, and KB version + freshness. Returns a structured readiness report.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Operational snapshot for the caller's tenant: KB version + freshness, queue depths (itineraries / draft meetings / active nudges), and the recent tool-invocation tail. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Find a Capitol office by ROOM CODE (e.g. 'SH-217', '2310 Rayburn', '167 Russell', 'H-232'), by MEMBER NAME (e.g. 'Cornyn', 'Ted Cruz', 'Womack'), or by COMMITTEE ('Senate Judiciary', 'Ways and Means', 'House Armed Services'). A room code returns the decoded location plus who currently holds it; a name returns that member's current office; a committee returns its office / principal hearing room. Member & committee assignments are the 119th Congress (volatile, live-source-stamped).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "A room code/address, or a member's name"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Turn-by-turn directions between two points in the Capitol complex. Each point can be a room code, a building name, OR a Metro station / landmark (e.g. 'Capitol South Metro' → '2412 Rayburn', 'Union Station' → '517 Hart', or to the 'Supreme Court' / 'Library of Congress'). Returns an ordered step list with mode (walk/tunnel/subway), minutes, and a flag wherever you re-clear security. Set accessible=true for a step-free route (or use accessible_route).

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Origin: room code, building name, or Metro station / landmark (e.g. 'Capitol South Metro')"
    },
    "to": {
      "type": "string",
      "description": "Destination: room code, building name, or Metro station / landmark"
    },
    "accessible": {
      "type": "boolean",
      "description": "Prefer a step-free / accessible route"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}

Step-free / accessible directions between two points in the Capitol complex by mobility profile (wheelchair, limited_mobility, stroller, low_vision). Routes over elevators/ramps only, avoids stairs, and surfaces OCAS accommodation contacts. Use this instead of route_between when step-free matters.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Origin: room code, building name, or Metro station / landmark (e.g. 'Union Station')"
    },
    "to": {
      "type": "string",
      "description": "Destination: room code, building name, or Metro station / landmark"
    },
    "mobility_profile": {
      "type": "string",
      "enum": [
        "wheelchair",
        "limited_mobility",
        "stroller",
        "low_vision",
        "any"
      ],
      "description": "Mobility profile (default: any step-free)"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}

What access a visitor needs for a zone of the Capitol complex: (visitor_type × zone) → allowed?, credential, escort, lead time, required docs, security entrance, and the granting authority. INFORMS, never grants — final authority is the member office / Capitol Police / Secret Service. Rules are volatile and live-source-stamped.

{
  "type": "object",
  "properties": {
    "visitor_type": {
      "type": "string",
      "enum": [
        "public",
        "constituent",
        "advocate",
        "press",
        "staff",
        "vip"
      ],
      "description": "Who is visiting"
    },
    "zone": {
      "type": "string",
      "enum": [
        "cvc_public",
        "capitol_tour",
        "house_gallery",
        "senate_gallery",
        "office_building",
        "committee_hearing",
        "subway",
        "grounds",
        "restricted"
      ],
      "description": "Which area of the complex"
    }
  },
  "required": [
    "visitor_type",
    "zone"
  ],
  "additionalProperties": false
}

Nearest restroom, exit, and food for a specific point — a room code (floor-specific, e.g. the exact nearest bathroom to SH-217), a building name, or GPS coordinates {lat, lon}. Returns specific named venues ranked by distance.

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "Room code or building name"
    },
    "lat": {
      "type": "number",
      "description": "Latitude (e.g. from device GPS) — pair with lon"
    },
    "lon": {
      "type": "number",
      "description": "Longitude — pair with lat"
    }
  },
  "anyOf": [
    {
      "required": [
        "location"
      ]
    },
    {
      "required": [
        "lat",
        "lon"
      ]
    }
  ],
  "additionalProperties": false
}

What you cannot bring into an area of the Capitol complex (security screening). zone: 'capitol_cvc' (the Capitol + Visitor Center — strictest, no food/water), 'gallery' (House/Senate galleries — no phones/cameras), or 'office_building' (the 6 office buildings — food & drink allowed). Always returns the universal weapon/hazard bans too. Volatile — live-source-stamped; confirm at visitthecapitol.gov before you travel.

{
  "type": "object",
  "properties": {
    "zone": {
      "type": "string",
      "enum": [
        "capitol_cvc",
        "office_building",
        "gallery"
      ],
      "description": "Which area you're entering"
    }
  },
  "required": [
    "zone"
  ],
  "additionalProperties": false
}

Optimize a multi-meeting Hill day. Give a list of meetings (each a member name or room code, with an optional time like '10:30a'). Returns a sequenced itinerary: batched by chamber side to minimize cross-campus crossings, the route + minutes between each stop, the cross-campus window flagged, 'leave-by' times when meetings are timed, and warnings for connections too tight to make.

{
  "type": "object",
  "properties": {
    "meetings": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "object",
        "properties": {
          "who": {
            "type": "string",
            "description": "Member name or room code"
          },
          "time": {
            "type": "string",
            "description": "Optional start time, e.g. '10:30a'"
          }
        },
        "required": [
          "who"
        ],
        "additionalProperties": false
      }
    },
    "accessible": {
      "type": "boolean",
      "description": "Plan step-free routes"
    }
  },
  "required": [
    "meetings"
  ],
  "additionalProperties": false
}