# SkillzDrive Developer Docs

> Markdown variant of the docs index at <https://www.skillzdrive.com/docs>.
> Agents: append `.md` to any `/docs/...` URL on this site for the
> agent-readable version. For the entire developer docs corpus in one
> fetch, use <https://www.skillzdrive.com/llms-full.txt>.

SkillzDrive is an MCP server that lets AI agents discover, install,
and execute "skills" — small, sandboxed packages that do real work
(PDF manipulation, image processing, spreadsheet generation, web
scraping, and more).

Three transports access the same drive:

- **MCP** — `https://www.skillzdrive.com/api/mcp` (Streamable HTTP). Best for AI agents.
- **REST** — `https://www.skillzdrive.com/api/v1`. Use from any language. Anonymous-capable for read endpoints.
- **CLI** — `npm install -g skillzdrive`. Symlinks skills into `.agents/skills/`, `.claude/`, `.cursor/`, etc.

## Start here

- [Quickstart](https://www.skillzdrive.com/docs/quickstart.md): connect a client and run your first skill in 5 minutes.
- [Custom Agent Integration](https://www.skillzdrive.com/docs/agent-integration.md): for developers building custom agents with direct MCP access.
- [AI Context system prompt](https://www.skillzdrive.com/docs/ai-context.md): drop-in context for non-MCP platforms (Claude Projects, Custom GPTs, .cursorrules).

## For developers

- [REST API overview](https://www.skillzdrive.com/docs/rest-api.md): base URL, auth, response shape, status codes.
- [REST API endpoint reference](https://www.skillzdrive.com/docs/rest-api/endpoints.md): every v1 route grouped by resource.
- [REST API webhooks](https://www.skillzdrive.com/docs/rest-api/webhooks.md): credit-alert subscriptions and HMAC verification.
- [CLI overview](https://www.skillzdrive.com/docs/cli.md): install and authenticate `skillzdrive`.
- [CLI command reference](https://www.skillzdrive.com/docs/cli/reference.md): every command with flags and exit codes.

## Guides

- [Discovering skills](https://www.skillzdrive.com/docs/guides/discovering-skills.md)
- [Executing scripts](https://www.skillzdrive.com/docs/guides/executing-scripts.md)
- [Authentication](https://www.skillzdrive.com/docs/guides/authentication.md)
- [Managing your drive with AI](https://www.skillzdrive.com/docs/guides/managing-drive.md)
- [Connecting an MCP client](https://www.skillzdrive.com/docs/guides/connecting.md)

## Concepts

- [MCP basics](https://www.skillzdrive.com/docs/mcp-basics.md)
- [Teams](https://www.skillzdrive.com/docs/guides/teams.md)
- [Sharing](https://www.skillzdrive.com/docs/guides/sharing.md)
- [Collections](https://www.skillzdrive.com/docs/guides/collections.md)
- [Security](https://www.skillzdrive.com/docs/security.md)

## MCP reference

- [Tools](https://www.skillzdrive.com/docs/reference/tools.md): all 29 `skills_*` tools.
- [Documentation resources](https://www.skillzdrive.com/docs/reference/resources.md): TOC + section reading model.
- [HTTP endpoints](https://www.skillzdrive.com/docs/reference/endpoints.md): MCP HTTP transport.

## Base URL summary

| Transport | URL |
|-----------|-----|
| MCP | `https://www.skillzdrive.com/api/mcp` |
| REST v1 | `https://www.skillzdrive.com/api/v1` |
| Marketplace JSON | `https://www.skillzdrive.com/marketplace.json` |

Auth header for MCP and REST: `Authorization: Bearer sk_live_<your-key>`.
Anonymous read access is rate-limited to 1 request per minute per IP;
include `X-Skillzdrive-Install-Id: <uuid>` for a per-installation
quota bucket.

## New to MCP?

MCP (Model Context Protocol) is an open standard for connecting AI
models to external tools. SkillzDrive is an MCP server — any
compliant client works. See [MCP basics](https://www.skillzdrive.com/docs/mcp-basics.md).
Once connected, install the `skillzdrive-mcp-guide` skill to teach
your agent all 29 tools automatically.