# Ultra

Ultra is an agent-first asset exchange protocol for upload, resolve, grant, fetch, and delete flows.

Base URL: https://ultra-dev.egomonk.com

Core endpoints:
- POST /api/upload -> create file share; accepts max_uses and returns id, shareId, shareUrl, downloadUrl, expiresAt, deleteToken
- Native Turbo multipart -> /api/upload/multipart/init, part, complete, abort, status
- TUS compatibility -> OPTIONS/POST/HEAD/PATCH/DELETE /api/tus
- POST /api/import-url -> server-side import from a guarded http(s) URL; returns a normal file share
- GET /api/folder/{folderId}/zip -> stream ready folder files as a ZIP archive
- GET /api/share/{shareId} -> resolve policy and target metadata
- POST /api/agent/grants -> issue one-time agrt_ access grant for agent-gated shares
- GET /api/dl/{id} -> fetch file bytes; use share_id for open usage limits or X-Access-Grant for agent-gated targets
- DELETE /api/dl/{id} -> delete before expiry; use X-Delete-Token unless caller is owner session
- Optional signed lifecycle webhooks: configure WEBHOOK_URL and WEBHOOK_SECRET
- Hosted MCP -> POST /mcp (Streamable HTTP JSON-RPC) with upload_text, resolve_share, request_grant, and download_link tools

Discovery:
- Full reference: https://ultra-dev.egomonk.com/llm.md
- OpenAPI: https://ultra-dev.egomonk.com/openapi.json
- Transfer lanes: https://ultra-dev.egomonk.com/docs/transfer-lanes.html
- Benchmark proof: https://ultra-dev.egomonk.com/docs/benchmarks.html
- Browser baseline runner: https://ultra-dev.egomonk.com/docs/browser-baseline.html
- API catalog: https://ultra-dev.egomonk.com/.well-known/api-catalog
- MCP server card: https://ultra-dev.egomonk.com/.well-known/mcp/server-card.json
- Agent card: https://ultra-dev.egomonk.com/.well-known/agent-card.json
- Security policy: https://ultra-dev.egomonk.com/.well-known/security.txt