Documentation
Everything you need to integrate and use SotaDocs.
Getting Started
Quick start guide, first API call, MCP setup.
- Quickstart
- Authentication
- First query
MCP Reference
Model Context Protocol tools and schemas.
- Available tools
- Schemas
- System prompts
API Reference
REST API endpoints, auth, and examples.
- Endpoints
- Rate limits
- Webhooks
Source Guides
Indexing packages, repos, URLs, and local files.
- Packages
- Repositories
- Local sync
Exports
Knowledge packs, Skills.md, and formats.
- Markdown packs
- JSONL format
- Skills.md
Security
Data handling, encryption, compliance.
- Data flow
- Retention
- Private repos
Getting Started
2. Install MCP or SDK
npx -y @sotadocs/mcpOr use our Node.js/Python SDKs.
MCP Tools Reference
| Tool | Description | Inputs |
|---|---|---|
sota_query | Query documentation with mode selection | source, version, mode |
sota_search | Vector search with question | query, sources, limit |
sota_blindspot | Generate blindspot report | source, model |
sota_export | Export pack or Skills.md | source, format, target |
sota_sync | Trigger source sync | source_id |
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/v1/query | POST | Query docs with mode selection |
/v1/search | POST | Vector search |
/v1/sources | GET/POST | Manage sources |
/v1/export | POST | Generate exports |
/v1/blindspot | POST | Blindspot report |
Authentication: Bearer token in Authorization header.
Source Guides
Indexing packages, repos, URLs, and local files.
Packages
Add npm, PyPI, or internal registries.
Repositories
Connect GitHub, GitLab, or Bitbucket.
Local Sync
Index local folders with version pinning.
Export Formats
Ship docs into every agent-friendly format.
Markdown Packs
Single-file exports for easy browsing.
JSONL
Structured output for downstream tools.
Skills.md
Agent bootstrap context files.
Security Controls
Keep sensitive sources protected at every step.
Data Flow
Understand ingestion and retrieval paths.
Retention
Set lifecycle rules for stored content.
Private Repos
Lock down access with scoped keys.