Developer preview

AI policy data for software and agents.

Search tracked measures, retrieve maintained jurisdiction baselines, compare markets, and ask policy questions through a versioned REST API and a small MCP server.

Quickstart

Useful before you authenticate.

Metadata, jurisdiction profiles, individual measures, constrained search, comparisons, and typed changes are open. Search always requires a substantive query or filter. There is no bulk catalogue endpoint.

Search California hiring measures
curl https://api.aipolicyradar.com/v1/search \
  -H 'Content-Type: application/json' \
  -d '{"jurisdiction":"US-CA","category":"hiring","limit":10}'
Example response
{
  "ok": true,
  "resolved_scope": {
    "collection": "us_states",
    "jurisdictions": ["US-CA"],
    "category": "hiring"
  },
  "items": [{
    "id": "m:US-CA:SB947",
    "title": "Employment: automated decision systems.",
    "stage": "introduced",
    "official_source_url": "https://leginfo.legislature.ca.gov/faces/billStatusClient.xhtml?bill_id=202520260SB947"
  }],
  "meta": {
    "api_version": "1.2.0",
    "release": "2026-08-27.1",
    "attribution": { "name": "AI Policy Radar", "url": "https://aipolicyradar.com" },
    "notice": "Policy activity data and research; not legal advice."
  }
}
Retrieve South Korea's baseline
curl https://api.aipolicyradar.com/v1/jurisdictions/KR

Versioned contract

The current stable surface is /v1. Additive fields may appear. Breaking changes require a new version.

Official sources

Measures and baseline instruments carry official-source links. Unsupported URL schemes are removed.

REST reference

Small, explicit surfaces.

The full request and response schemas are in the OpenAPI contract. Every response includes the Radar release, coverage dates, attribution, and machine-readable notice.

GET/v1/meta

Release, coverage counts, categories, sectors, and discovery links.

GET/v1/jurisdictions

All tracked global jurisdictions and US states.

GET/v1/jurisdictions/{code}

One jurisdiction profile and its measure counts. Maintained narrative baselines are included where available.

GET/v1/measures/{id}

One measure, status, categories, date, and official-source URL.

POST/v1/search

Constrained, cursor-paginated search. Maximum page size: 50.

GET/v1/compare

Deterministic comparison for two to five jurisdiction codes.

GET/v1/changes

Typed policy or coverage changes. Enrichment is excluded from the default policy feed.

POST/v1/answers

Catalogue-grounded answers with automatic official-source research. Developer key required.

Developer access

One key for REST and MCP answers.

Preview keys are free. A key permits ten automatic answers and two forced live-research answers per UTC day. Public deterministic reads do not use this allowance.

Request a preview key
The key is displayed once. Store it as a secret and never place it in browser code or a public repository.
Ask through REST
curl https://api.aipolicyradar.com/v1/answers \
  -H "Authorization: Bearer $RADAR_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: my-request-001' \
  -d '{"question":"Which US states have enacted AI hiring rules?","mode":"auto"}'
Agent access

A small Streamable HTTP MCP server.

The public endpoint exposes five deterministic read tools. The authorized endpoint adds ask_policy_radar and uses the same developer key and answer allowance as REST.

Public endpoint

https://mcp.aipolicyradar.com/mcp

Authorized endpoint

https://mcp.aipolicyradar.com/mcp/authorized

Remote MCP client configuration
{
  "mcpServers": {
    "ai-policy-radar": {
      "url": "https://mcp.aipolicyradar.com/mcp"
    }
  }
}

Add this block in Claude, Cursor, or another client that supports remote Streamable HTTP MCP servers. The public endpoint needs no key.

Public MCP tools
search_policy
get_measure
get_jurisdiction_baseline
compare_jurisdictions
get_recent_changes
Authorized addition
ask_policy_radar

All MCP tools return JSON text and valid structuredContent. The structured result includes release provenance, attribution, and the same policy-research notice as REST.

Quotas

Open reads, bounded generation.

OperationLimitAccess
Metadata and direct retrieval120 per IP per minuteOpen
Search and changes30 per IP per minuteOpen
Automatic answer10 per key per UTC dayDeveloper key
Forced live research2 per key per UTC dayDeveloper key

Quota responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. A 429 response also states the reset time and points higher-volume users to hello@aipolicyradar.com.

Provenance and boundaries

The boundary travels with the payload.

Human documentation is not enough for agent systems. Every response and MCP structured result carries the same compact envelope.

Shared meta envelope
{
  "release": "2026-08-27.1",
  "data_as_of": "2026-08-26",
  "global_data_as_of": "2026-08-21",
  "us_state_data_as_of": "2026-08-26",
  "information_type": "policy_research",
  "legal_advice": false,
  "official_sources_control": true,
  "notice": "Policy activity data and research; not legal advice.",
  "attribution": { "name": "AI Policy Radar", "url": "https://aipolicyradar.com" }
}
The /changes endpoint does not treat catalogue enrichment as a real-world policy event. Ask for ?class=coverage when you want release-scope changes. The default policy feed includes only verified external movement.
Use and attribution

Build useful things. Preserve the source.

Public analysis materially based on Radar results should state: “Data accessed through AI Policy Radar,” together with the response release and data-as-of date. Official sources remain controlling.

The preview does not offer a bulk catalogue download. Do not use the API to reconstruct or commercially republish the maintained compilation, editorial summaries, or full catalogue. Reasonable caching, research, citation, application features, and agent retrieval are welcome. For higher volume, commercial redistribution, or private monitoring, contact hello@aipolicyradar.com.

API changelog

Version 1.0.1

Released August 14, 2026. Aligns the version convention, adds explicit resolved scope to search responses, and distinguishes maintained national baselines from measure-level US state profiles.

Version 1.0.0

Added open deterministic REST reads, typed changes, developer keys, generated answers, OpenAPI, agent discovery through llms.txt, and public and authorized MCP endpoints.