Attify for developers
You can send an agent's interactions to Attify in four ways (connect the customer's systems, connect an agent platform or observability account, stream through the Ingest API or an SDK, or export OpenTelemetry traces), and read audited results back through a read-only API, llms.txt and an MCP server. The integration carries three things Attify cannot infer: the agent's claimed outcome, any handoff, and the customer's own ids.
Send#
Event schema proven.ingest/1, JSON Schema at /docs/ingest/schema.json, OpenAPI at /docs/ingest/openapi.json. Full reference: /docs/ingest. Walkthrough: how to send your agent's data.
What to carry#
outcome.claimedin the job type's words: supportresolved/not_resolved; sales meetingsmeeting_booked/no_meeting; bookingsbooked/not_booked. The latest claim is the one tested.handoffwithto:human,agentorexternal.customerandexternal_ref: ids in the customer's own systems, so repeat contacts and spot checks can be found there.feedbackof kindresolutiononly for an explicit "did this resolve your issue?" answer; ratings go ascsat,thumbsornps.
What Attify checks#
Signatures, timestamps on arrival (events more than 5 minutes late are flagged, and their interactions never scored as witnessed), sequence gaps and reused ids. Witnessed data counts toward verification only after the customer consents and reconciles.
Read#
GET /api/v1/vendors?job_type=support-resolution,GET /api/v1/vendors/{slug},GET /api/v1/index.POST /api/v1/verifywith an attestation; keys at/.well-known/proven-keys.json(JWKS, Ed25519).- MCP (Streamable HTTP,
POST /mcp):lookup_vendor,verify_attestation,get_traction_report,get_index,explain_provenance. /llms.txtfor agents that start there.
Questions
Is there an SDK?
- Yes: attify-ingest for Python (pip install attify-ingest, standard library only) and TypeScript (npm install attify-ingest, no dependencies). Both sign, number, buffer and retry; nothing else. Any HTTP client works too.
How are requests authenticated?
- With the deployment's key: HMAC-SHA256 of the timestamp and the raw body in the Proven-Signature header for /v1/ingest/events, or a bearer token for OTLP. Timestamps more than 300 seconds off are refused.
Can another agent read audited results?
- Yes: the read-only API at /api/v1 (OpenAPI at /api/v1/openapi.json), llms.txt, and an MCP server at /mcp with tools such as lookup_vendor, verify_attestation and get_index.