# Spec Stack

Spec Stack is an API-first knowledge base and autonomous ecosystem for software projects.
It allows you to centralize project specs, organize them into atomic "Entities" (notes, bugs, code specs, PRs), and manipulate them programmatically via API.

## Relevant Documentation

- Main API Reference: `https://specstack.xyz/api-docs.md`
- Human-Readable Documentation: `https://specstack.xyz/docs`

## Quick API Guide

1. Base URL: `https://specstack.xyz/api/v1`
2. Authentication: Require an API key passed via the `Authorization: Bearer sk_...` header.
3. Model Context Protocol (MCP): Connect your AI agents securely via `https://specstack.xyz/api/mcp` to use native tools like `create_specstack_task`.
4. Core Data Structure:
   - **Projects**: The top-level workspace (`/projects`).
   - **Entities**: The atomic units of knowledge within a project (`/entities`). You must provide `format` (e.g. markdown) and `title`/`content`. Use `kind` (e.g. artifact, bug) and `tags` (e.g. ["auth", "critical"]) to organize them effectively.

See `/api-docs.md` for full schema and endpoint definitions.