API Reference

The VaultPlane API lets you search the registry, fetch server details, and submit new MCP servers programmatically.

Base URL

https://www.vaultplane.com/api

GET

/api/servers

Search and list MCP servers.

Query Parameters

q — Search query (searches name and description)

category — Filter by category slug

sort — Sort by: popular, newest, name, stars

page — Page number (default: 1)

limit — Results per page (default: 24)

Example

GET /api/servers?q=github&sort=popular&limit=10

GET

/api/servers/:slug

Get full details for a single server, including capabilities, permissions, compatibility, and versions.

Example

GET /api/servers/github-mcp

GET

/api/categories

List all categories with server counts.

POST

/api/servers/submit

Submit a new MCP server for review.

Request Body (JSON)

name * — Server name

description * — Server description

githubUrl * — GitHub repository URL

maintainerName * — Your name

docsUrl — Documentation URL

installCommand — Install command (e.g., npx @mcp/server)

maintainerOrg — Organization name

All endpoints return JSON. List endpoints include pagination metadata:

{
  "servers": [...],
  "pagination": {
    "page": 1,
    "limit": 24,
    "total": 53,
    "totalPages": 3
  }
}

Coming Soon

The API is currently open. Rate limiting and API key authentication will be added in a future release.