Akil MCP - New York City Edition
NYC public records for AI agents.
Akil MCP connects Claude, ChatGPT, Codex, and custom agents to a hosted civic
data layer built around real workflows, reusable identifiers, and source-backed
public records.
The product is the hosted MCP server. This repository is the public connection
home for developers, evaluators, and partner teams who want to understand what
Akil can do before connecting an agent.
Connect
There is nothing to install for normal use.
MCP endpoint: https://mcp.askakil.ai/mcp
| Client | How to connect |
|---|
| Claude | Add Akil as a custom connector, paste the MCP URL, and sign in when prompted. |
| ChatGPT | Use connectors where available, add the MCP URL, and complete the Akil authorization flow. |
| Codex | Register Akil as a streamable HTTP MCP server. Developer access can send an API key as a bearer token. |
| Custom agents | Use OAuth for user-authorized sessions or API keys for backend jobs and partner workflows. |
Full setup and docs:
What agents can do
Akil is organized around civic workflows rather than a single dataset.
| Workflow | What the assistant can check |
|---|
| Business location | Permits, licenses, inspections, operating context, and location constraints |
| Property diligence | Ownership, tax-lot identity, deeds, sales, permits, violations, and tax records |
| Public money | Awards, payments, contracts, agency budgets, and recipient history |
| Influence and government | Lobbying, campaign finance, legislation, votes, hearings, and officeholder context |
| Organization checks | Nonprofit registries, audits, funding history, compliance records, and aliases |
| Spatial questions | Address, BBL, district, neighborhood, radius, polygon, corridor, and time-windowed queries |
Why this exists
A general model can reason. Akil gives it records to reason from.
The useful part is not the number of tools. It is that fragmented public
records come back with stable identifiers, source context, and next steps an
assistant can actually follow.
Anchor-first design
Akil responses are designed to keep agents oriented around durable civic
identifiers:
flowchart LR
Q["User question"] --> A["Anchor"]
A --> BBL["BBL / tax lot"]
A --> EIN["EIN / organization"]
A --> Agency["Agency"]
A --> District["District / boundary"]
A --> License["License / application"]
A --> Time["Time window"]
BBL --> R["Source-backed answer"]
EIN --> R
Agency --> R
District --> R
License --> R
Time --> R
BBL for tax lots, buildings, ownership, permits, sales, tax records, and violationsEIN for nonprofits, audits, awards, filings, and organization checksAgency for budgets, contracts, payments, rules, hearings, and payroll contextDistrict or other boundaries for place-based questionsLicense and application identifiers for regulated businessesTime window for bounded, usable queries
These anchors let an assistant move from one public record system to another
without losing the subject of the question.
Example prompts
I am looking at a storefront lease. What public records should I check before signing?
Who owns this building, and are there recent permits or violations tied to the tax lot?
Show public funding, contracts, and payments tied to this organization.
What changed in this council district over the last year?
Is this restaurant, liquor, tobacco, cannabis, or sidewalk-cafe location worth checking more closely?
See the workflow recipes:
Standards and discovery
For clients, directories, and evaluators that probe machine-readable surfaces:
- Server Card:
https://mcp.askakil.ai/.well-known/mcp/server-card.json (also at /.well-known/mcp.json)
- OAuth resource metadata:
https://mcp.askakil.ai/.well-known/oauth-protected-resource (RFC 9728)
- Protocol: serves current-era MCP clients (protocol revision
2026-07-28) and 2025-era legacy clients on the same endpoint
- Health:
https://mcp.askakil.ai/health reports version and live tool count
- Tool behavior: every tool is read-only and non-destructive, declares MCP safety annotations, returns a source-attribution footer, and states plainly when a search is capped or empty
- Registry manifest:
server.json in this repository
What this repository is
This public repository contains:
- connection metadata
- setup notes
- workflow examples
- public-facing security contact information
It does not contain the hosted server implementation, data pipelines, database
schema, private infrastructure, or internal operating documents.
Public surfaces
Security
Please do not post tokens, API keys, private prompts, or sensitive records in
GitHub issues. See SECURITY.md for reporting guidance.
About
Akil is built by Akil Ventures, Inc., a Delaware
corporation building civic intelligence infrastructure for AI agents.
License
MIT. This public repository documents the hosted MCP server and lightweight
connection metadata. The hosted Akil service runs proprietary infrastructure
and is not open source.