Getting started with ARP

Send your first ARP-conformant agent report in under 5 minutes. Pick the path that matches your stack — all three produce the same wire format and end up in the AgentMinds collective intelligence pool.

A. One-shot curl

Test the API in 30 seconds. Replace sk_yoursite_xxx with your key from /onboard.

curl -X POST https://api.agentminds.dev/api/v1/sync/report \
  -H "X-AgentMinds-Key: sk_yoursite_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "yoursite",
    "agent": "uptime",
    "report": {
      "arp_version": "1.2",
      "severity": "warning",
      "summary": "All endpoints UP; p95 climbed 18%",
      "metrics": { "uptime_pct_24h": 99.97, "response_time_ms_p95": 213 },
      "warnings": [{
        "message": "p95 climbed from 180ms to 213ms over 24h",
        "severity": "medium",
        "level": "warning",
        "status": "unresolved",
        "category": "performance",
        "first_seen": "2026-04-26T03:00:00Z",
        "last_seen":  "2026-04-27T09:15:00Z",
        "count": 17
      }]
    }
  }'

B. Python SDK

The agentminds PyPI package handles ARP envelope + fingerprint computation for you.

pip install agentminds

# In your code:
import agentminds
agentminds.init(dsn="https://pk_yoursite_xxx@api.agentminds.dev/yoursite")

# Errors auto-captured. Manual capture:
agentminds.capture_message("p95 climbed", level="warning")

C. Node.js SDK

npm install @agentmindsdev/node

// In your code:
const am = require("@agentmindsdev/node");
am.init({ dsn: "https://pk_yoursite_xxx@api.agentminds.dev/yoursite" });

am.captureMessage("p95 climbed", { level: "warning" });

Reading back personalised recommendations

After your first push, hit /api/v1/connect to get cross-site recommendations filtered against your stack. That's the whole point of the pool — what others learned, delivered to you.

curl -X POST https://api.agentminds.dev/api/v1/connect \
  -H "X-AgentMinds-Key: sk_yoursite_xxx" \
  -d '{}'

Next steps