# MCP.so — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Discover and explore MCP servers on the mcp.so marketplace by browsing categories, searching by tags, viewing detailed server information, and checking available tools and integrations. Find top-rated servers, compare clients, and filter options to identify the perfect MCP solutions for your needs.

**Category:** Developer Tools | **Website:** [mcp.so/](https://mcp.so/) | **Docs:** [parse.bot/marketplace/d8072689-168f-4009-92e5-f5cf4460c580/mcp-so-api](https://parse.bot/marketplace/d8072689-168f-4009-92e5-f5cf4460c580/mcp-so-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_server_detail

Fetch full details for a single MCP server including name, tags, category, language, GitHub URL, configuration JSON, and description. The slug and optional author identify the server. Returns a single server object with all available metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `author` | string | No | Author handle (e.g. 'modelcontextprotocol', 'ahujasid'). Required for servers that share slug names with different authors. |
| `slug` | string | Yes | Server slug identifier (e.g. 'github', 'puppeteer', 'blender'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/get_server_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"author":"<string>","slug":"<string>"}'
```

### get_server_tools

Fetch the tools (capabilities) exposed by an MCP server. Returns tool names and descriptions. Not all servers expose tool metadata — servers without tools return an empty array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `author` | string | No | Author handle (e.g. 'modelcontextprotocol', 'ahujasid'). Required for servers that share slug names with different authors. |
| `slug` | string | Yes | Server slug identifier (e.g. 'github', 'puppeteer', 'blender'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/get_server_tools \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"author":"<string>","slug":"<string>"}'
```

### get_top_servers_with_metadata

Fetch a list of top MCP servers with full metadata including name, URL, GitHub URL, category, tags, and language. Fetches detail pages for each server so response time increases with limit. Useful for building a catalog of the most popular servers with complete information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of servers to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/get_top_servers_with_metadata \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### list_categories

List all available MCP server categories with their slugs and URLs. Returns the complete set of categories used to organize servers on the marketplace.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_clients

List MCP client applications (e.g. Cursor, VSCode, Windsurf, Cline). Returns all known clients that support the MCP protocol.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/list_clients \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_servers

Fetch a paginated list of MCP servers. Returns server names, URLs, and short descriptions. Supports filtering by tab (featured or latest). Each page returns up to ~50 servers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `tab` | string | No | Filter tab. Accepted values: 'featured', 'latest'. Omitting returns all servers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/list_servers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","tab":"<string>"}'
```

### list_servers_by_category

List MCP servers filtered by category slug. Returns servers on the specified page. Some categories may have all results on page 1.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `slug` | string | Yes | Category slug (e.g. 'developer-tools', 'browser-automation', 'databases'). Obtain from list_categories endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/list_servers_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","slug":"<string>"}'
```

### list_servers_by_tag

List MCP servers filtered by tag name. Returns paginated results of servers that have the specified tag applied.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `tag` | string | Yes | Tag name (e.g. 'github', 'postgresql', 'browser-automation'). Obtain from list_tags endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/list_servers_by_tag \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","tag":"<string>"}'
```

### list_tags

List all available MCP server tags with their names and URLs. Tags are user-generated labels applied to servers for discovery.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/list_tags \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_servers

Search MCP servers by keyword. Returns matching servers with name, URL, and short description. Results are not paginated — all matches for the query are returned in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'database', 'github', 'filesystem'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mcp-so-api-d8072689/search_servers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```