Developer Documentation Site for an Agent SDK
Overview
The developer documentation portal for an internal agent-cloud SDK (“Claude as a Service”). Authored in MDX and published with Mintlify, covering concepts, quickstarts, SDK references, and API specs.
Why It Exists
A platform SDK is only as good as its documentation. This site gives developers a single, navigable home for getting started, core concepts, authentication, billing, and full client references, essential for adoption of the underlying agent platform.
What We Built
A Mintlify-configured docs site (docs.json) spanning an introduction, quickstart,
authentication, billing, and architecture pages, plus deep sections: concepts
(sessions, tools, MCP servers, streaming), advanced topics (error handling, budget
management, workspace config), and SDK references for both JavaScript/TypeScript and
Python. API documentation is driven from an openapi.yaml, and a
DOCS_AUDIT_REPORT.md tracks coverage and quality. CLI and use-case guides round
out the set.
Technologies & Approach
Mintlify provides a modern, search-friendly docs experience with MDX authoring and OpenAPI integration, so API reference pages stay in sync with the spec. Content is organized to serve both quick-start readers and developers needing exhaustive SDK detail.
Outcome / Impact
A structured, audited documentation portal that makes a multi-language agent SDK approachable, covering sessions, tools, MCP server bundles, streaming, and budget management.
Capabilities Demonstrated
- Building developer documentation portals (Mintlify / MDX)
- Multi-language SDK reference authoring (JS/TS + Python)
- OpenAPI-driven API documentation
- Documenting agent/LLM concepts: sessions, tools, MCP, streaming