docs / mcp-registry

MCP Server & Agent-Skill Registry API

base /mcp-registry/v16 endpoints

post/mcp-registry/v1/search1 credit

Normalized cross-registry search over the Official MCP Registry, Glama and Smithery (and skills via GitHub). Dedups the same server across registries by canonical GitHub repo and returns cross-registry presence.

Parameter		Allowed / range	Description
query	required	—	Free-text search (server name, capability, keyword).
type = mcp	optional	mcp · skill · all	Which ecosystem to search.
source = all	optional	all · official · glama · smithery	Restrict to a single source (default: all reachable).
sort = relevance	optional	relevance · popularity · recent	Result ordering.
limit = 25	optional	1–100	Max merged results (1-100).

Try in playground →

post/mcp-registry/v1/server_detail1 credit

Full merged profile for one MCP server across every registry it appears in: manifest (tools/capabilities/transport), install paths (packages/remotes/connections), license, GitHub repo health, and cross-registry presence (how many registries list it = trust signal).

Parameter		Allowed / range	Description
id	required	—	A GitHub URL/slug (owner/repo), a Smithery qualifiedName, a Glama id, or an Official registry name. github_url is the most reliable (it joins all registries).
repo_health = true	optional	—	Include GitHub repo-health enrichment (stars/issues/archived/license). Default true.

Try in playground →

post/mcp-registry/v1/skill_detail1 credit

Metadata for one agent-skill repo (GitHub-backed). Fetches the repo + its SKILL.md frontmatter (name/description/license) + repo health.

Parameter		Allowed / range	Description
id	required	—	GitHub URL or owner/repo slug of the skill repository.

Try in playground →

post/mcp-registry/v1/security_signals2 credits

HEURISTIC risk signals for an MCP server (NOT a safe/unsafe certification). Flags permission breadth (fs/network/exec), credential/env-var requests, repo health (archived/low-adoption), prompt-injection patterns in description/manifest, and corroboration (cross-registry presence). Always returns a disclaimer.

Parameter		Allowed / range	Description
id	required	—	GitHub URL/slug or Smithery qualifiedName of the server to scan.

Try in playground →

post/mcp-registry/v1/trending1 credit

New / rising entries. MCP: most-used servers on Smithery + latest on the Official registry. Skills: recently-created GitHub skill repos.

Parameter		Allowed / range	Description
type = mcp	optional	mcp · skill	Ecosystem.
limit = 20	optional	1–50	Max results (1-50).

Try in playground →

post/mcp-registry/v1/list_sourcesfree

The registries this engine aggregates, their roles, auth status and live reachability. Free.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/mcp-registry/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"filesystem","limit":10}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}