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.