---
title: "Search MCP servers and select an exact canonical name"
method: GET
path: "/v1/search"
---

# Search MCP servers and select an exact canonical name

`GET /v1/search`

## Request

- Base URL: `https://api.mcpcensus.com`
- URL: `https://api.mcpcensus.com/v1/search`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Returns ranked candidates. Search output is not a Preflight decision.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Ranked matches with evidence cards

- SearchResult
  - `ok` boolean
  - `count` integer
  - `results` HealthCard[]
    - `server_name` string
    - `health` 'healthy' | 'issues' | 'unknown'
    - `health_problems` string[]
    - `verified` boolean: Enough applicable registry and distribution surface is confirmed under the current published method. This is not first-party identity or a security finding.
    - `gh_stars` integer, nullable
    - `months_since_push` number, nullable
    - `gh_archived` boolean, nullable
    - `npm_deprecated` boolean, nullable
    - `name_collision_count` integer
    - `registry_status` string

## Other responses

- `429`: Burst, daily, refresh, or per-server cooldown limit reached

---

[API](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api.md) · [All operations](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api/revisions/934a7da85b52?raw)