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/apiEndpoints
/api/serversSearch 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/api/servers/:slugGet full details for a single server, including capabilities, permissions, compatibility, and versions.
Example
GET /api/servers/github-mcp/api/categoriesList all categories with server counts.
/api/servers/submitSubmit 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
Response Format
All endpoints return JSON. List endpoints include pagination metadata:
{
"servers": [...],
"pagination": {
"page": 1,
"limit": 24,
"total": 53,
"totalPages": 3
}
}Rate Limiting
The API is currently open. Rate limiting and API key authentication will be added in a future release.