---
title: "Search and filter MCP servers"
method: GET
path: "/api/v1/search"
---

# Search and filter MCP servers

`GET /api/v1/search`

## Request

- Base URL: `https://allmcps.com`
- URL: `https://allmcps.com/api/v1/search`
- Auth: none declared

Query active MCP servers by keyword or category with optional limit parameters. Public, unauthenticated.

## Query parameters

- `q` string
- `category` string
- `limit` integer
- `transport` 'stdio' | 'remote'
- `verified` '1'

## Response `200`

Successful search results

- object
  - `total` integer
  - `query` string, nullable
  - `category` string, nullable: The canonical category the request resolved to (the exact stored name), or null when no category filter was applied.
  - `servers` object[]
    - `id` string
    - `name` string
    - `description` string
    - `category` string
    - `url` string
    - `isOfficial` boolean
    - `isVerifiedActive` boolean
    - `upvotes` integer
    - `installName` string
    - `detailUrl` string
    - `markdownUrl` string

## Other responses

- `400`: Unknown category (error code "unknown_category"). Fetch /api/v1/categories for the accepted names, labels, and slugs.
- `500`: Server error while querying the catalog.

---

[API](https://skmtc.dev/allmcps/apis/allmcps-directory-api.md) · [All operations](https://skmtc.dev/allmcps/apis/allmcps-directory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/allmcps/apis/allmcps-directory-api/revisions/0a42338f0f1e?raw)