This folder holds agent-facing material for coding assistants (Cursor, Claude Code, Codex, CLI bots, etc.).
| Document | Purpose |
|---|---|
| MCP_SETUP.md | Wire Cursor / Claude Code / Codex / remote agents to a QuantDinger backend via the quantdinger-mcp MCP server (local stdio + remote HTTP) |
| AGENT_ENVIRONMENT_DESIGN.md | Architecture: layered contracts (docs → commands → API/MCP), security boundaries, roadmap, implementation checklist |
| AI_INTEGRATION_DESIGN.md | How external AI agents (P4) and autonomous strategy AIs (P5) consume QuantDinger via a versioned, scoped Agent Gateway |
| AGENT_QUICKSTART.md | Operator + integrator walkthrough: issue a token, call the Gateway, run paper trades |
| agent-openapi.json | Machine-readable contract for /api/agent/v1 (OpenAPI 3.0) |
| ../architecture/API_CONVENTIONS.md | Shared HTTP conventions (envelopes, auth, Public/Internal tiers) |
| ../api/openapi.yaml | Human Web API spec (flask-smorest; migration in progress) |
Language policy: Machine-readable schemas, route names, scopes, environment variables, and tool identifiers remain in English as the canonical contract. Human setup guides are maintained in paired editions: 中文入口 and this English entry. The automation-oriented .cursor/skills/ content remains English-only so it behaves consistently across tools and locales.