API Reference
API Reference
The Skills MCP API is a REST API served by a Go HTTP server. All endpoints return JSON.
Base URL
http://localhost:8891/api/v1
Authentication
Authentication is optional (opt-in). When enabled, use Bearer tokens:
Authorization: Bearer <access_token>
Endpoints
Auth
| Method | Path | Description |
|---|---|---|
| GET | /auth/me | Get current user session |
| POST | /auth/login | Login with email and password |
| POST | /auth/logout | End current session |
| POST | /auth/signup | Create a new account |
Skills
| Method | Path | Description |
|---|---|---|
| GET | /skills | List all skills (supports tag/namespace filtering) |
| GET | /skills/:name | Get a skill by name |
| GET | /skills/:name/versions | List versions of a skill |
Admin
| Method | Path | Description |
|---|---|---|
| GET | /admin/dashboard | Get status counts |
| GET | /admin/users | List all users |
| GET | /admin/clients | List registered clients |
Account
| Method | Path | Description |
|---|---|---|
| GET | /account/tokens | List API tokens |
MCP Transport
The MCP protocol is available via Streamable HTTP at POST /mcp.
This endpoint supports the full MCP tool and prompt registry.