io.github.civdotiq由 GitHub 账号 civdotiq 发布v1.0.0更新于 Oct 24, 2026
U.S. civic data for AI agents: reps, votes, bills, finance, lobbying, cited gov sources. 47 tools.
远程 MCP 服务器，提供美国公民数据——议员、法案、投票、竞选资金、游说与选区统计，均来自可引用的政府来源。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.civdotiq%2Fciviq/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"civiq": {
"type": "http",
"url": "https://civdotiq.org/api/mcp"
}
}
}Civic intelligence from government sources, organized for public use.
civdotiq.org • API Reference • Contribute • License
[CI status] [License: Apache-2.0] [@civiq/sdk on npm]
A civic intelligence platform. Enter an address to find your federal and state representatives, with voting records, federal campaign finance, committee assignments, legislative activity, and machine-learning-powered analysis of money-in-politics patterns. Local (city/county) government: not covered. Local records lack a shared standard or central source; CIV.IQ intends to add them only once a verified public source exists.
Data comes from official government records. Most are read straight from the agency's API or bulk files; some are read through named open datasets, such as OpenStates for state legislatures and the Congress Trading Monitor for parsed STOCK Act filings. All analysis is statistical, with confidence scores and methodology disclosed. If data is unavailable, the interface and the response payload say so explicitly. Nothing is fabricated.
Honest coverage matrix: docs/COVERAGE.md. It is the canonical answer to "what does CIV.IQ actually cover?" — every other claim in this README defers to that page.
Representatives: Federal and state legislators with photos, contact info, committee assignments, and voting records.
Campaign Finance: Federal only — FEC contributions, PAC spending, expenditure tracking, and donor sector analysis. State campaign finance is not currently available (FollowTheMoney.org is in maintenance mode during the OpenSecrets merger).
Intelligence Layer: Statistical analyzers that cross-reference voting records with campaign finance, lobbying filings, stock trades, and committee jurisdictions to surface patterns of potential influence. Every insight carries a confidence score, methodology note, and correlation-not-causation disclaimer.
Money Report: Address-based lookup that traces the path from campaign contributions through committee assignments to legislative outcomes for your specific representatives.
Regulations & Comment Periods: Federal Register integration for proposed rules, final rules, executive orders, and open public comment periods.
State Legislatures: All 50 states via OpenStates — legislators, bills, committees, and calendars. Per-legislator vote history is in progress. Interactive district boundary maps for all 7,383 state legislative districts. State-level campaign finance, lobbying, and stock-trade data are not part of state coverage.
Local Government: Not covered (city/county). Local records lack a shared standard or central source; CIV.IQ intends to add them only once a verified public source exists.
District Intelligence: Demographics, economic indicators (BLS employment data), federal spending (USASpending), infrastructure metrics, and bills ranked by relevance to each congressional district.
Nostr Publishing: Civic events (new bills, votes, hearings) are signed and published to the Nostr network for decentralized, verifiable distribution.
The table lists the primary sources. Other federal agency datasets (CDC PLACES, CMS, FEMA, FBI, FDIC, VA, Treasury, CFPB, NHTSA, EPA, College Scorecard, and more) power district and intelligence features. In total CIV.IQ reads 40 data sources: 29 government and 11 open datasets. The full list and the counting rule are in docs/COVERAGE.md.
No data is fabricated or generated. When a source is unavailable, the response says so.
Add API keys to .env.local. All are free:
See .env.example for the full list, including Nostr publishing and ActivityPub federation.
Verify at localhost:3000/api/health.
Next.js 16, React 18, TypeScript (strict), Tailwind CSS, SWR, Zustand, MapLibre GL, D3.js, Recharts, Redis (Upstash + ioredis), Zod, simple-statistics, HuggingFace Transformers (small models), Google Gemini AI, nostr-tools.
17 statistical analyzers cross-reference the federal data domains:
One more analyzer, the regulation analyzer, is in the code but not listed because nothing calls it.
Every insight carries: confidence score (0–1), data-as-of timestamp, methodology description, and a disclaimer that correlation does not imply causation.
All models are small and run server-side through HuggingFace Transformers. Setting CIVIQ_ML_PIPELINES=off disables them.
scripts/compute-influence-clusters.py) served as JSONThree packages are extracted as standalone npm workspace packages:
Additional scripts for performance benchmarking, data/ML processing, and security scanning are defined in package.json.
See CONTRIBUTING.md.
Apache License 2.0. Copyright 2019-2026 Mark Sandford.
Use it, modify it, distribute it. Include the copyright, license, and NOTICE file per Apache 2.0 Section 4. Credit is appreciated but not required: "Powered by CIV.IQ." The government data the API serves is in the public domain. The @civiq/* npm packages are MIT. The CIV.IQ name and logo are trademarks and require written permission to use. See LICENSE and NOTICE.
Mark Sandford - [email protected]
来源：README.md，提交 ee9e7b4
Representative lookup by address
Find everyone who represents a full street address: the two US Senators and House member (bioguideId, name, party, state, district, chamber) plus every state legislator for the address (name, party, district, chamber, phone, email). The Census Geocoder resolves the exact districts; a ZIP code alone is not accepted because ZIPs cross district lines.
zipcity必填state必填street必填State delegation list
List all federal legislators for a state (both senators and all House representatives).
state必填Legislator profile
Get detailed profile for a specific legislator including committees, social media, biography, and contact info.
bioguideId必填Legislator comparison
Compare multiple legislators side-by-side. Returns profiles for each bioguideId.
bioguideIds必填Bill search
Search for bills in Congress. Provide `query` for full-text keyword/topic search (e.g. "broadband", "veterans healthcare") via GovInfo's full-text bill index; results include a congress-type-number id you can pass to get_bill_details. Without `query`, returns the most recently updated bills (optionally filtered by type).
typelimitquerycongressBill details
Get detailed information about a specific bill including sponsor, cosponsors, committees, actions, and policy area.
billId必填Voting history
Get a legislator's recent voting record. Returns vote ID, bill info, position, result, and date.
limitchamber必填bioguideId必填House roll call vote
Get details about a specific House roll call vote including all member positions. Note: only House votes are available via this tool.
sessioncongressrollCallNumber必填Campaign finance summary
Get FEC campaign finance data for a legislator including total raised/spent, PAC contributions, and industry breakdown.
cyclebioguideId必填Lobbying filings search
Search Senate LDA lobbying filings from the complete corpus — every quarterly report (LD-2) in the covered window, not a sample. Returns registrant, client, spending amount, issue codes and the committees each filing touches, plus exact totals. Filter by quarter, by organization, or both. Amounts are plausibility-gated (income <= $5M, expenses <= $50M per filing).
yearlimitquarterorganizationFederal spending lookup
Get federal contracts and grants for a congressional district from USASpending.gov.
state必填districtInfluence chain trace
Trace lobbying money through contributions, committee assignments, and votes for a legislator. Shows the path from lobbying org to legislative outcome.
bioguideId必填District cross-domain profile
District representative info combined with STATE-level context across domains: environment (EPA), safety (FEMA, CFPB), health (CMS), economy (EIA, education, research, banking). Domain counts are statewide aggregates — these sources do not publish district-level rollups.
stateCode必填districtNumber必填Industry regulatory landscape
For a given industry sector: all regulatory actions (EPA, FDA, NHTSA), lobbying filings, campaign contributions, and committee jurisdiction. Maps sector to agencies and oversight committees.
sector必填stateCodePolicy area ecosystem
For a Congress.gov policy area: related agencies, industry sectors, lobbying activity, committee oversight, and Federal Register keywords. Uses policy-area-map as the cross-domain join hub.
policyArea必填Committee details
Get detailed information about a congressional committee including members, jurisdiction, and subcommittees.
committeeId必填Federal Register search
Search Federal Register for rules, proposed rules, notices, and executive orders.
typelimitqueryagencyDistrict profile
Get comprehensive information about a congressional district including demographics, economics, and representative.
stateCode必填districtNumber必填EPA facility search
Search EPA-regulated facilities by state, ZIP, or SIC code. Returns facility name, address, compliance status, violations, and penalties.
ziplimitstate必填sicCodeDistrict environmental profile
Environmental profile for a congressional district: regulated facilities, active violations and toxic releases, all scoped to the district by county FIPS. Superfund sites are returned STATEWIDE, not per district, because the EPA layer serving them carries no county FIPS. Includes serving representative.
stateCode必填districtNumber必填Environmental influence analysis
Cross-reference EPA violations in a district with lobbying and campaign finance. Maps facility SIC codes to sectors, finds lobbying in those sectors by the district rep, checks EPA-oversight committee membership overlap, and identifies environmental legislation votes.
stateCode必填districtNumber必填State climate normals
NOAA climate normals for a state: average temperature, min/max temperatures, precipitation, and snowfall from 30-year normal period. Requires NOAA_TOKEN.
state必填State climate profile
Climate profile for a state: NOAA climate normals, severe weather event history, and the state delegation's Environment committee membership for climate policy context.
yearstateCode必填FEMA disaster search
Search FEMA disaster declarations by state, year, or type (DR=Major Disaster, EM=Emergency, FM=Fire Management). Returns declaration number, dates, programs, and designated areas.
typeyearlimitstate必填District disaster history
Disaster history for a congressional district: FEMA declarations, recurring hazard types, total assistance amounts. Cross-references with USASpending disaster relief in the district.
stateCode必填yearsBackdistrictNumber必填Crime statistics search
FBI UCR crime statistics by state and offense type. Returns actual counts, rates per 100,000, clearances, and national comparison. Offense types: violent-crime, property-crime, HOM, RPE, ROB, ASS, BUR, LAR, MVT, ARS.
yearstate必填State public safety profile
State crime trends with national comparison, Judiciary committee memberships from the state's congressional delegation, and relevant policy area context for criminal justice legislation.
stateCode必填yearsBackConsumer complaint search
Search CFPB consumer complaints by company, product, state, or date range. Returns complaint details including issue, response, and timeliness.
sizestatedateTocompanyproductdateFromDistrict consumer complaints
Consumer complaints aggregated by congressional district using ZIP-district mapping. Shows top complained-about companies, products, and issues for a district.
stateCode必填districtNumber必填Consumer protection influence
Cross-reference top complained-about companies in a state with lobbying registrants (entity resolution fuzzy match) and campaign contributions to the district representative. Checks rep votes on Finance-related legislation. Shows correlations only — not causation.
stateCode必填districtNumber必填Housing affordability data
HUD Fair Market Rents and income limits by county FIPS code. Returns rental rates by bedroom count and income thresholds (very low, extremely low, low) by household size.
countyFips必填District housing profile
Housing affordability profile for a congressional district: HUD Fair Market Rents and income limits for district counties, representative's Housing committee membership, and relevant housing policy context.
stateCode必填districtNumber必填Vehicle recall search
Search NHTSA vehicle recalls by make, model, and/or year. Returns campaign number, affected component, safety summary, consequence, remedy, and whether to park the vehicle immediately.
makeyearmodelVehicle complaint search
Search NHTSA consumer complaints about vehicles by make, model, and/or component. Returns incident details including injuries, deaths, crashes, fires, and complaint summary.
makemodelcomponentHealthcare provider search
Search CMS hospitals and nursing homes by state with quality ratings. Returns overall star ratings, safety/mortality comparisons for hospitals, and inspection/staffing ratings for nursing homes.
citytypestate必填District healthcare profile
Healthcare infrastructure for a congressional district: CMS hospitals and nursing homes with quality ratings, representative's Health committee membership, and pending health legislation context.
stateCode必填districtNumber必填State energy profile
State energy profile from EIA: total consumption, production, electricity generation, renewable percentage, and top energy sources. Returns production mix and trends.
state必填Energy policy influence
Cross-reference state energy profile with energy sector lobbying registrants (entity resolution fuzzy match), Energy/Commerce committee membership, campaign contributions, and energy legislation votes. Shows correlations only — not causation.
stateCode必填districtNumber必填College search
Search College Scorecard for higher education institutions by state and/or name. Returns admission rate, graduation rate, average net price, median earnings, median debt, and size.
namelimitstateDistrict education profile
Higher education landscape for a congressional district: colleges/universities by state with outcomes data, representative's Education committee membership, and relevant education policy context.
stateCode必填districtNumber必填NIH grant search
Search NIH-funded research grants by state, institution, or topic. Returns project title, principal investigator, award amount, NIH institute, and organization.
limitstatetopicinstitutionDistrict research profile
NIH-funded research in a congressional district: grants by state, top institutions, top-funded topics, total award amounts, and representative's Science/Health committee membership.
stateCode必填districtNumber必填FDIC institution search
Search FDIC-insured banks and financial institutions by state, name, or city. Returns total assets, deposits, number of offices, charter class, and regulator.
citynamelimitstateDistrict banking profile
Banking landscape for a congressional district: FDIC-insured institutions, total deposits/assets, recent bank failures, and representative's Banking/Financial Services committee membership.
stateCode必填districtNumber必填Federal fiscal data
Federal fiscal overview from Treasury: national debt, monthly revenue by category, and spending by category. Returns current figures and fiscal year totals.
yearFederal debt context
Current federal debt with context: total public debt outstanding, debt held by public vs intragovernmental holdings, and record date. Useful for fiscal policy discussions.
无需输入参数。
已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
git clone https://github.com/civdotiq/civ.iq.gitcd civ.iqnpm installcp .env.example .env.local# RequiredCONGRESS_API_KEY= # api.congress.gov/sign-upFEC_API_KEY= # api.open.fec.gov/developersCENSUS_API_KEY= # api.census.gov/data/key_signup.htmlOPENSTATES_API_KEY= # openstates.org/accounts/profile
# RecommendedUPSTASH_REDIS_REST_URL= # upstash.com (caching)UPSTASH_REDIS_REST_TOKEN=GOOGLE_GENERATIVE_AI_API_KEY= # aistudio.google.com/apikey (AI summaries)
# Optional (enhanced features)FRED_API_KEY= # fredaccount.stlouisfed.org/apikeysDATA_GOV_API_KEY= # api.data.gov/signup (Regulations.gov)GOVINFO_API_KEY= # api.govinfo.gov/docsnpm run devsrc/├── app/│ ├── api/ # API routes (public contract: /api/v1 + openapi.json)│ └── (civic)/ # Pages (representatives, districts, legislation, etc.)├── components/│ ├── intelligence/ # Insight cards, leaderboards, influence chains│ └── ... # Shared UI, search, visualizations├── features/ # Feature modules│ ├── campaign-finance/│ ├── legislation/│ ├── representatives/│ └── state-legislature/├── lib/│ ├── intelligence/ # Analyzers, ML models, embeddings, entity resolution│ ├── nostr/ # Nostr event signing and relay publishing│ ├── data-sources/ # Federal Register, FRED, SEC, lobbying services│ └── ... # API clients, services, utilities├── hooks/ # Custom React hooks└── types/ # TypeScript definitionspackages/├── sdk/ # @civiq/sdk (TypeScript API client)├── civic-statistics/ # @civiq/civic-statistics (confidence scoring, correlation)└── entity-resolution/ # @civiq/entity-resolution (entity matching, deduplication)npm run dev # Dev server at localhost:3000npm run build # Production buildnpm run lint # ESLintnpm run type-check # TypeScript strict checknpm test # Run all tests (Jest)npm run test:e2e # Playwright end-to-end testsnpm run validate:all # lint + type-check + test + buildnpm run diagnose:apis # Test API connectivity