Skip to main content
GET
List MCP servers with optional filters and pagination

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Query Parameters

name
string

Filter MCP servers by name (case-insensitive partial match) Name substring to filter servers by

Example:

"github"

toolkits
string

Comma-separated list of toolkit slugs to filter servers by

auth_config_ids
string

Comma-separated list of auth config IDs to filter servers by

order_by
enum<string>
default:updated_at

Field to order results by Field to use for ordering the results

Available options:
created_at,
updated_at
Example:

"updated_at"

order_direction
enum<string>
default:desc

Direction of ordering Sort direction (ascending or descending)

Available options:
asc,
desc
Example:

"desc"

page_no
integer
default:1

Page number for pagination (1-based) Page number to retrieve

Required range: x > 0
Example:

1

limit
integer
default:10

Number of items per page (default: 10) Number of servers to return per page

Required range: x > 0
Example:

10

Response

Successfully retrieved MCP servers. Returns a paginated list of server configurations including connection details and command instructions.

Paginated response containing MCP servers

items
object[]
required

Array of MCP server configurations

Example:
total_pages
number
required

Total number of pages in the paginated response

Example:

5

current_page
number
required

Current page number being returned

Example:

1