# AICompliancePulse

AICompliancePulse is a regulatory-intelligence feed that tracks AI governance documents
(regulations, frameworks, guidelines, executive orders) across jurisdictions and distills
them into a weekly pulse digest (published every Sunday), plus a searchable regulation
index that updates with each run.

---

## REST API

Base URL: https://www.aicompliancepulse.com
(Always use the www host — the apex domain 301-redirects, and HTTP clients drop the
Authorization header on cross-host redirects, silently downgrading keyed requests.)

### Authentication

All endpoints accept an optional Bearer token (API key from /developers/keys):

    Authorization: Bearer acp_live_<key>

- Authenticated: 120 requests/min per key (own quota bucket; RateLimit-* headers in response)
- Anonymous: 100 requests/min shared per client IP

Errors: 401 invalid key, 429 rate-limited (Retry-After header), 503 auth unavailable.

### Endpoints

GET /api/pulse/latest
  Returns the most recent pulse digest (structured JSON; `date` field = publication
  date) with its regulation items inlined as `data.regulations[]` — one call answers
  "what changed in the latest pulse?".

GET /api/pulse/by-date?date=YYYY-MM-DD
  Returns the pulse digest for a specific date, with `data.regulations[]` inlined.
  Pulses are published weekly (Sundays); other dates return `{"data": null}`.

GET /api/pulse/search?q=<text>&framework=<value>&jurisdiction=<value>&scope=<value>&instrument=<value>&topic=<value>&updateType=<value>&pulseDate=<YYYY-MM-DD>&limit=<n>
  Full-text + facet search over regulations. `framework` and `jurisdiction` are mutually
  exclusive. `limit` max 50, default 10.
  Facet values are display names, URL-encoded — e.g. `framework=EU%20AI%20Act`,
  `jurisdiction=US-FED`. Invalid values return a 400 listing every valid option, or call
  the MCP `list_filters` tool for the full enums.
  Note: /api/pulse/latest already inlines its regulations; use pulseDate here when you
  want to COMBINE a pulse window with other facets (e.g. pulseDate + framework).

---

## MCP Server (Model Context Protocol)

Endpoint: https://www.aicompliancepulse.com/api/mcp  (Streamable HTTP)
Auth: Bearer API key (same key as REST). Requires a valid key — anonymous not accepted.

Quota: limits are per MCP HTTP request. A single agent interaction (initialize + tools/list +
tools/call) is multiple HTTP requests, each counted once against the 120/min per-key quota.

### Connect — direct Streamable HTTP (Claude Code, Cursor, etc.)

Claude Code CLI:

    claude mcp add --transport http aicompliancepulse \
      https://www.aicompliancepulse.com/api/mcp \
      --header "Authorization: Bearer acp_live_<key>"

.mcp.json snippet:

    {
      "mcpServers": {
        "aicompliancepulse": {
          "type": "http",
          "url": "https://www.aicompliancepulse.com/api/mcp",
          "headers": { "Authorization": "Bearer acp_live_<key>" }
        }
      }
    }

### Connect — stdio proxy (Claude Desktop and other stdio-only clients)

    npx mcp-remote https://www.aicompliancepulse.com/api/mcp \
      --header "Authorization: Bearer acp_live_<key>"

Claude Desktop claude_desktop_config.json:

    {
      "mcpServers": {
        "aicompliancepulse": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://www.aicompliancepulse.com/api/mcp",
            "--header",
            "Authorization: Bearer acp_live_<key>"
          ]
        }
      }
    }

### Note on Claude.ai web

Claude.ai web connectors require OAuth 2.0 — Bearer-key auth is not accepted there.
Use Claude Desktop, Claude Code CLI, or Cursor with the Bearer key instead.

### Available tools

- get_latest_pulse          Returns the most recent regulatory pulse digest. (scope: read:pulses)
- get_pulse_by_date         Returns the pulse for a given date (YYYY-MM-DD). (scope: read:pulses)
- search_regulations        Full-text + facet search over regulations. (scope: read:regulations)
- list_filters              Returns valid enum values for all search facets. (scope: read:regulations)

---

## CLI

Package: aicompliancepulse  (npm)

    aicompliancepulse today [--api-key acp_live_<key>]
    aicompliancepulse search <query> [--api-key acp_live_<key>]

Key can also be set via environment variable: AICOMPLIANCEPULSE_API_KEY=acp_live_<key>

Docs: https://www.aicompliancepulse.com/developers/cli
API keys: https://www.aicompliancepulse.com/developers/keys
MCP docs: https://www.aicompliancepulse.com/developers/mcp