# Axiom Vault — AI Agent Instructions
# https://axiomvault.io

## About
Axiom Vault is a molecular binding prediction marketplace powered by a Sovereign Proof Engine.
The system has generated 31M+ predictions, each blockchain-anchored on BSV for tamper-proof integrity.
Predictions include ADMET profiling, scaffold analysis, and compliance scoring.

## Discovery Files
- Agent Card (A2A): https://axiomvault.io/.well-known/agent.json
- MCP Manifest: https://axiomvault.io/.well-known/mcp.json
- Organization: https://axiomvault.io/.well-known/organization.json
- Website: https://axiomvault.io/.well-known/website.json

## API Access
All API requests require the header: X-ACO-Protocol: mcp
When HMAC authentication is enabled, also send:
- X-ACO-Timestamp: current time in milliseconds
- X-ACO-Token: HMAC-SHA256(secret, "mcp:<timestamp_ms>") as hex
Without valid auth headers, standard browser rate limits apply.
Base URL: https://axiomvault.io

### Available Endpoints
- GET  /api/marketplace/predictions?q={query}&page=1&limit=50 — Search predictions
- GET  /api/marketplace/predictions/{id}?email={email} — Prediction detail (tier-gated)
- GET  /api/marketplace/stats — Aggregate statistics
- GET  /api/marketplace/plans — Subscription tiers and pricing
- GET  /api/marketplace/proof/{prediction_id} — Blockchain proof lookup
- GET  /api/marketplace/proof/verify/{txid} — On-chain BSV verification
- POST /api/marketplace/subscribe — Start subscription (body: {email, plan})
- POST /api/marketplace/unlock — Per-record unlock at $2 (body: {email, prediction_id})
- GET  /api/marketplace/viewer-tier?email={email} — Check subscription tier
- POST /api/contact — Human escalation (body: {name, email, category, message})

## Subscription Tiers
| Tier | Price | Daily Limit | Binding Ceiling | Access Level |
|------|-------|-------------|-----------------|--------------|
| Explorer | Free | 10/day | 0.50 | DISCOVERY tier data only |
| Researcher | $29/mo | 500/day | 0.65 | + PROFESSIONAL tier data |
| Institutional | $299/mo | 5000/day | 0.80 | + ENTERPRISE tier + CSV export |
| Sovereign | $2,999/mo | Unlimited | 0.97 | Full access + priority support |
| Per-record | $2 each | — | < 0.55 only | Single prediction unlock |

## Rate Limits
- AI agents: 30 requests per 15 minutes
- Include X-ACO-Protocol: mcp header on all API requests
- SMILES strings are truncated to 8 characters for free-tier access

## Authentication
HMAC-SHA256 token required when server has AXIOM_ACO_SECRET configured.
Without valid token, requests are treated as normal browser traffic with stricter rate limits.
Pass subscriber email as query parameter (?email=user@example.com) for tier-appropriate data access.

## Allowed Actions
- Search and browse predictions
- Retrieve prediction details (within tier limits)
- Verify blockchain proofs
- Check marketplace statistics
- Initiate subscriptions and per-record unlocks
- Escalate to human support via /api/contact

## Prohibited Actions
- Bulk scraping or systematic data extraction
- Circumventing rate limits or tier restrictions
- Accessing VAULT-tier internal data
- Automated subscription creation without user consent

## Human Escalation
For questions requiring human judgment, contact:
- Web: https://axiomvault.io/contact
- API: POST /api/contact with {name, email, category, message}
- Categories: sovereign, licensing, billing, general