Skip to content
Waypoint

API

Read-only and free to use, no key needed. Responses are JSON and allow cross-origin requests. Please keep it under a request a second.

MethodPathWhat it returns
GET/api/v1/listings?q=postgres&kind=mcp&sort=rankSearch. kind is mcp, skill or plugin; sort is rank, trending, rating, quality, new or relevance; page and per_page (up to 100).
GET/api/v1/listings/mcp/io.github.acme/weatherOne listing with its manifest and the checks from its latest evaluation.
GET/v0/servers?limit=30&cursor=…MCP servers in the official MCP Registry's format. Point a registry client here to use this hub as a sub-registry.
GET/v0/servers/io.github.acme%2FweatherOne server's latest version. Add /versions for all of them, or /versions/1.2.0 for one.
POST/api/v1/licenses/verifyBody {"key": "wp_…"}. For publishers of paid listings: is this buyer's license key valid, and for what.

Using the hub as an MCP sub-registry

Every server keeps its server.json exactly as published. We add our evaluation under _meta["io.waypoint/evaluation"], which registry clients ignore unless they know it:

curl https://waypointmcp.com/v0/servers?limit=1

{ "servers": [ { "server": { "name": "io.github.acme/weather", … },
    "_meta": {
      "io.modelcontextprotocol.registry/official": { "status": "active", "isLatest": true, … },
      "io.waypoint/evaluation": { "grade": "A", "score": 94, "rank": 3,
        "rating": { "average": 4.6, "count": 18 }, "url": "https://waypointmcp.com/l/mcp/io.github.acme/weather" } } } ],
  "metadata": { "count": 1, "nextCursor": "io.github.acme/weather" } }