# DoNotAct Agent Discovery

Discovery version: `2026-06-18.1`

This page is the owned-surface map for agents, crawlers, directories and developer tools that need to understand DoNotAct without scraping marketing copy.

## Canonical Entry Points

- `https://donotact.com/llms.txt` - compact agent context.
- `https://donotact.com/.well-known/llms.txt` - well-known mirror for clients that prefer standard discovery paths.
- `https://donotact.com/llms-full.txt` - extended context for agents that need product boundaries, evidence feeds and integration paths.
- `https://donotact.com/agent.json` - machine-readable product and integration manifest.
- `https://donotact.com/openapi.json` - API contract.
- `https://donotact.com/mcp` - remote MCP endpoint, authenticated by bearer API key.
- `https://donotact.com/mcp.json` and `https://donotact.com/.well-known/mcp.json` - MCP install metadata.
- `https://donotact.com/sitemap.xml` - crawlable public surface list.
- `https://donotact.com/robots.txt` - crawl policy.

## HTTP Discovery Headers

Every DoNotAct response should expose discovery without forcing a crawler to guess paths:

```http
Link: </llms.txt>; rel="service-desc"; type="text/plain"; title="DoNotAct llms.txt", </.well-known/llms.txt>; rel="service-desc"; type="text/plain"; title="DoNotAct well-known llms.txt", </agent.json>; rel="describedby"; type="application/json"; title="DoNotAct agent manifest", </openapi.json>; rel="service-desc"; type="application/vnd.oai.openapi+json"; title="DoNotAct OpenAPI"
X-DoNotAct-Discovery: /llms.txt
X-DoNotAct-Agent-Manifest: /agent.json
X-DoNotAct-Discovery-Version: 2026-06-18.1
```

## Non-spam Distribution Rule

DoNotAct discovery is for owned surfaces, directories that explicitly accept submissions, and technical conversations where a concrete risk-gateway failure mode is already being discussed. It is not for unsolicited email, mass DMs, scraped lists or generic forum blasting.

## Suggested Agent Summary

DoNotAct is a fail-closed Risk Gateway for prediction-market agents before they spend. It returns stop/go diagnostics, safe operating limits, dispute lifecycle, resolution-risk evidence, watchlists, alerts, receipts and machine-payment paths. The caller keeps execution, custody, private keys, signing and routing outside DoNotAct.

## Measuring Success

Track success through:

- hits to `/llms.txt`, `/.well-known/llms.txt`, `/agent.json`, `/openapi.json`, `/mcp`, and `/docs/discovery`;
- referrals from directories or repos that explicitly accepted the listing;
- authenticated first diagnostic calls after discovery;
- conversion from free key to paid monitoring.

Do not report ROI, alpha, avoided loss, fill quality or trading performance from discovery traffic.
