CivicDataForge
README.md
# CivicDataForge — Official Public-Records Data for AI Agents
Developer guides: [discover tools before billing](https://github.com/equinoxaifinance-rgb/civicdataforge-mcp/blob/main/guides/discovery-before-billing.md) · [inspect the Bengaluru sample](https://github.com/equinoxaifinance-rgb/civicdataforge-mcp/blob/main/guides/bengaluru-sample.md).
n8n: [open our approved template in n8n's library](https://n8n.io/workflows/20002-validate-us-property-request-scope-with-civicdataforge-and-http-request/) · [setup and result guide](guides/n8n/README.md). Validate one public property request before a separate purchase; no credentials, evidence retrieval or automatic purchase in this bounded client.
**Start with one request:** [try the no-charge input and purchase-option check](https://civicdataforge.pages.dev/connect-agent?utm_source=github&utm_medium=developer&utm_campaign=first_request_20260925#try-request), or [copy the cURL walkthrough](guides/first-request.md). This validates request syntax and current purchase options; it does not retrieve evidence, establish record coverage, or initiate payment.
[](https://glama.ai/mcp/servers/equinoxaifinance-rgb/civicdataforge-mcp)
[](https://glama.ai/mcp/servers/equinoxaifinance-rgb/civicdataforge-mcp)
[](https://allmcps.com/mcp/civicdataforge-government-evidence?verify=6641b3ab-b25c-4414-a18a-8dfc47acf45e)
CivicDataForge gives MCP-compatible agents structured access to official government records through a stable
credential-safe MCP relay backed by Apify. The official bundle exposes ten focused tools across unified evidence routing, property compliance, healthcare
integrity, regulated-facility safety, and Norwegian company evidence. Additional research products remain discoverable in the public
catalog without bloating the default MCP tool set.
Website: <https://civicdataforge.pages.dev>
Government data catalog: <https://civicdataforge.pages.dev/government-data-api>
Machine-readable catalog: <https://civicdataforge.pages.dev/api-catalog.json>
Apify Store: <https://apify.com/civicdataforge>
Live STR proof: <https://apify.com/civicdataforge/str-permit-registry/examples/check-orlando-str-permits>
Dated product proof: <https://civicdataforge.pages.dev/proof>
## Pricing at a glance
Tool discovery and the request check are free. Evidence calls are paid per result:
- Apify Store (Government Evidence Gateway): $0.01 per Actor start plus $0.10 per evidence packet on Apify's Free plan, lower on paid Apify plans.
- AWS Marketplace API/MCP: $0.10 per successful evidence request; failed requests and idempotent retries are not billed.
- One-off audits and weekly permit monitoring are also available.
Current prices and terms: <https://civicdataforge.pages.dev/pricing.md>
## Add the remote MCP server
Use this Streamable HTTP endpoint:
```text
https://civicdataforge.pages.dev/mcp
```
In Claude Code:
```bash
claude mcp add --transport http civicdataforge https://civicdataforge.pages.dev/mcp
```
Public `initialize` and `tools/list` discovery work without a credential. The hosted gateway supports two explicit caller-owned paths:
- For CivicDataForge's metered hosted evidence gateway, send the issued CivicDataForge key as either `Authorization: Bearer YOUR_CIVICDATAFORGE_KEY` or `X-CivicDataForge-Key: YOUR_CIVICDATAFORGE_KEY`.
- For direct Apify-backed Actor calls, send your own Apify token in `X-Apify-Token`:
```text
X-Apify-Token: YOUR_APIFY_TOKEN
```
The hosted CivicDataForge path meters successful bounded evidence requests through its active commercial route;
direct Actor calls remain caller-owned Apify usage. Each Actor has its own pricing, input schema, source notes,
and usage limits on its Store page. Never send a CivicDataForge key to an Actor endpoint. On the shared remote
MCP endpoint, keep the credential types in their documented headers and never send both in one request.
## Run the installable stdio gateway
This repository also contains a credential-safe stdio distribution for MCP clients and Glama deployments.
Its ten schemas are available during discovery without a credential. Calls require the installing user's
own `APIFY_TOKEN`; the gateway never embeds a developer token and never returns the token in results.
```bash
npm ci
APIFY_TOKEN=YOUR_APIFY_TOKEN npm start
```
For an MCP client, use `node /absolute/path/to/server.mjs` as the command and supply `APIFY_TOKEN` through
the client's secret environment configuration. Successful calls return the Apify run ID, dataset ID, status,
and up to 1,000 dataset rows. Larger outputs remain available from the caller-owned Apify dataset.
### Portable GitHub and ModelScope configuration
MCP clients and ModelScope can install the open bridge directly from the canonical GitHub repository. The
bridge does not contain a CivicDataForge or Apify credential. Tool discovery works without a token; each
caller supplies `APIFY_TOKEN` for actual Actor runs.
```json
{
"mcpServers": {
"civicdataforge": {
"command": "npx",
"args": ["-y", "github:equinoxaifinance-rgb/civicdataforge-mcp"],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}
```
This GitHub install route is the current portable STDIO path. Clients that support remote MCP directly can use
the hosted endpoint `https://civicdataforge.pages.dev/mcp` described above instead.
## 简体中文：接入与使用边界
CivicDataForge 为支持 MCP 的智能体提供结构化政府公开记录。默认网关包含统一证据路由器与九个聚焦工具，覆盖
房产合规、医疗排除名单、受监管设施安全与挪威企业证据。每条结果都应保留官方来源链接、覆盖范围与对应
Actor 的数据限制；这些数据用于研究和合规辅助，不替代主管机关的最终认定。
当前可用的远程 Streamable HTTP 接入地址为：
```text
https://civicdataforge.pages.dev/mcp
```
公开的 `initialize` 与 `tools/list` 无需凭证。首次使用可先访问 [免费请求检查](https://civicdataforge.pages.dev/connect-agent#try-request)，它不检索记录，也不发起付款。
托管证据网关使用已激活的 CivicDataForge 密钥，通过 `Authorization: Bearer YOUR_CIVICDATAFORGE_KEY` 传递。
如选择直接运行 Apify Actor，则使用调用方自己的 `X-Apify-Token: YOUR_APIFY_TOKEN`。同一请求不要同时发送两类密钥。
CivicDataForge 不在仓库、npm 包或返回结果中嵌入发布者 Token。
简体中文完整接入手册提供两个从单一标识符到证据凭证的可复制路径：一个已支持美国辖区的
物业地址，以及一个印度公司 CIN。手册明确列出同步 REST 端点、输入、来源字段、新鲜度字段、
SHA-256 凭证和生产异步运行方式：
<https://civicdataforge.pages.dev/zh-cn-developer>
机器可读版本：<https://civicdataforge.pages.dev/zh-cn-developer.json>
印度公司 Actor 不在十工具默认网关中；需要时可通过统一证据路由器调用或单独加载：
```text
https://mcp.apify.com/?tools=civicdataforge/india-company-registry
```
该中文入口只提供现有美国房产证据和印度公司证据，不声称中国企业登记数据库、GSXT 批量
API 或中国本地官方记录覆盖。
ModelScope 与本地 MCP 客户端可直接从官方 GitHub 仓库安装开放网关：
```json
{
"mcpServers": {
"civicdataforge": {
"command": "npx",
"args": ["-y", "github:equinoxaifinance-rgb/civicdataforge-mcp"],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}
```
该 GitHub 安装方式和上方 Apify 托管网关均为当前可用路径。十个默认工具包括统一证据路由器、短租许可、佛罗里达州住宿执照、
房产违规、HHS-OIG LEIE 医疗排除名单、餐厅检查、多州与德州托育许可、EPA ECHO 设施证据和挪威企业证据。
挪威企业数据适用 NLOD 2.0，可在遵守署名、变更说明及其他许可条件下商业再利用；但若记录含个人数据，
购买方仍须针对自己的处理目的审查隐私义务与合法依据。该 Actor 排除自然人角色、联系人和街道地址行，
且不输出 KYC、采购、制裁或资格裁决。
这些工具不是消费者报告，不得作为信贷、保险、就业、住房或其他资格决定的唯一依据。
使用者应核对原始政府记录，并遵守每个数据源的适用条款和限制。
## Current tools
| Tool | What it returns | Typical workflow |
|---|---|---|
| `civicdataforge-evidence-gateway` | One minimized, rights-labeled packet across U.S., India, global screening, EPA, or China-facing intake tasks, with monitoring and optional transaction state | Route one identifier to the correct evidence workflow without losing provenance or uncertainty |
| `str-permit-registry` | Self-service address evidence decisions plus official STR permit/license records, dates, source links, and normalized jurisdiction fields across 32 supported US jurisdictions | Property verification, portfolio research, registry monitoring, and municipal research |
| `fl-dbpr-vacation-rentals` | Florida DBPR lodging-license records across seven official district files | State-license validation and property diligence |
| `property-violations` | Normalized code and building-violation records from supported municipal sources | Property compliance research and monitoring |
| `leie-exclusion-screening` | HHS-OIG LEIE records filtered by name, NPI, state, specialty, or exclusion type | Healthcare compliance and credentialing support |
| `restaurant-inspection-scores` | Official restaurant inspection and violation records across seven supported jurisdictions | Facility safety research and monitoring |
| `multistate-childcare-licensing` | Supported state childcare licensing, inspection, and deficiency fields | Multi-state facility research |
| `texas-childcare-licensing` | Licensed childcare operations with inspection and deficiency fields where the state publishes them | Facility research and compliance support |
| `epa-echo-facility-compliance` | Bounded EPA ECHO facility identity, published compliance status, inspections, enforcement summaries, and evidence receipts | Facility research with environmental-safety verdict fixed to UNKNOWN |
| `norway-company-evidence` | Exact nine-digit organisation-number or bounded company-name evidence from Brønnøysundregistrene, with NLOD attribution, explicit match states, and receipt hashes | Norwegian entity verification, supplier onboarding evidence, and procurement research without an eligibility verdict |
The official bundle is intentionally limited to the unified gateway plus nine focused tools. India company-registry, cross-border restricted-party evidence, and NYC
film-permit products remain available through their Actor pages and focused suite-specific MCP URLs in the
public catalog.
### Norway source-rights and availability boundary
The Norway Actor uses the official Brønnøysundregistrene Central Coordinating Register for Legal Entities and labels output under the [Norwegian Licence for Open Government Data (NLOD) 2.0](https://data.norge.no/nlod/en/2.0). NLOD permits commercial copying, modification, combination, and distribution subject to attribution, change disclosure, and its exclusions. That permission does not replace a buyer-specific privacy and legal-basis review where a record bears personal data. The Actor deliberately omits natural-person roles, direct contacts, and street address lines.
The 2026-08-23 logged-out readback returned HTTP 200 for both the [public Store page](https://apify.com/civicdataforge/norway-company-evidence) and Actor API. The API identifies public Actor `L9veafufAtLFNgiWP` and binds both `latest` and `norway-public-candidate` to successful build `mnKblLCjPc0BdqrME`, version `0.1.3`. The provider deployment receipt records bounded owned canary run `6xyIIolQYf3d1u0KR` as `SUCCEEDED` with one exact-identifier `MATCH` for organisation number `974760673`; this is deployment verification, not external customer usage. The canary run and dataset objects are not public evidence surfaces—their logged-out API routes returned HTTP 403—so use the public Actor/API metadata plus caller-owned run receipts for downstream verification.
## Fastest proof path
The public Orlando task runs the STR Actor with a bounded input and exposes the resulting official records,
field structure, source links, and integration routes:
<https://apify.com/civicdataforge/str-permit-registry/examples/check-orlando-str-permits>
For a downloadable evaluation artifact, the website publishes a 100-row STR sample covering the verified
29-jurisdiction evaluation release together with a SHA-256 checksum:
<https://civicdataforge.pages.dev/str-permit-sample>
## Use boundary
These tools support research and compliance workflows. They are not consumer reports and must not be used as
the sole basis for credit, insurance, employment, housing, or other eligibility decisions. Preserve the
official source links and review the source-specific limitations documented by each Actor.
## Reliability before execution
Agents can inspect the public, receipt-bound reliability surfaces before spending compute or treating a
publisher response as usable:
- Source-level status and component reasons: <https://civicdataforge.pages.dev/source-health.json>
- Cross-market scope, refresh target, and fail-closed rules: <https://civicdataforge.pages.dev/reliability.json>
The China-facing route is a Simplified-Chinese integration layer over the named U.S. and India products. It
does not claim a China-native registry or bulk access to Chinese government records.
## Repository scope and license
This repository publishes discovery metadata for the hosted remote MCP endpoint and an installable stdio
gateway that dispatches the same ten tools to Apify; the data Actors still run on Apify. Gateway code,
metadata, and documentation are licensed under the included [MIT License](LICENSE). Government-source terms
and record-level use restrictions remain source-specific and are documented on the corresponding Actor pages.
The open bridge is deliberately not the CivicDataForge core. Source acquisition adapters, reconciliation
pipelines, field-presence and drift monitors, source-rights controls, evidence-graph implementation, partner
connectors, operational ledgers, and deployment configuration are maintained separately and are not licensed
under this repository's MIT license. See [SECURITY.md](SECURITY.md) for the disclosure boundary and private
evaluation route.
TDQS
A4.5/5.0
Scored across 7 tools
Disambiguation5/5
Each tool targets a distinct data domain (STR permits, Florida DBPR, property violations, LEIE exclusion, restaurant inspections, childcare licensing), and the descriptions explicitly cross-reference other tools to steer agents away from misselection. The two childcare tools are clearly separated by geographic scope, eliminating ambiguity.
Naming Consistency4/5
All tool names follow a consistent lowercase-hyphenated style, which is predictable and readable. However, they are noun phrases rather than a verb_noun pattern (e.g., 'property-violations' vs. 'search_permits'), so while the convention is consistent, it deviates from the common verb-first structure.
Tool Count5/5
With 7 tools, the server is well-scoped for its stated purpose of civic data research. Each tool covers a specific, non-trivial dataset, and the count is neither too thin nor overwhelming for agents to navigate.
Completeness4/5
The tool set covers major civic data categories (permits, violations, health inspections, exclusion screening, childcare licensing) with no obvious dead ends. Minor gaps exist, such as general business licensing or building permits across all states, but the current surface is coherent for the intended domain.
Maintenance
ActivityActive
ResponsivenessNo issues