# Mcpservers — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Search and discover MCP servers, clients, and Claude skills from mcpservers.org, including featured and official recommendations organized by category. Browse detailed server information, remote server options, and find exactly what you need with powerful search and filtering capabilities.

**Category:** Developer Tools | **Website:** [mcpservers.org/](https://mcpservers.org/) | **Docs:** [parse.bot/marketplace/6734cdd4-b967-4e3f-ae85-27524919453c/mcpservers-org-api](https://parse.bot/marketplace/6734cdd4-b967-4e3f-ae85-27524919453c/mcpservers-org-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get featured servers

Retrieve featured servers from the homepage. Returns all servers displayed on the main landing page including sponsors and highlighted community entries.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/get_featured_servers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get official servers

List official MCP servers with pagination. These are servers verified by the platform as officially maintained.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/get_official_servers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get server detail

Retrieve detailed information about a specific MCP server by its slug. Returns the server name, description, GitHub repository link, and rendered README content. GitHub stars are client-side rendered and may not be available via server-side parsing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Server slug in owner/repo format (e.g., 'chroma-core/chroma-mcp'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/get_server_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get servers by category

List servers by category slug. Returns paginated results for the specified category. Categories are URL slugs visible in site navigation (e.g. web-scraping, database, search).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug (e.g., 'web-scraping', 'database', 'search'). |
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/get_servers_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### List claude skills

List reusable Claude Skills (agent skills). These are pre-built skill configurations that can be used with Claude and other AI agents.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/list_claude_skills \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List clients

List MCP client applications. These are desktop apps, libraries, and tools that connect to MCP servers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/list_clients \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List remote servers

List curated remote MCP servers. These are cloud-hosted servers accessible via OAuth or open endpoints, typically from major SaaS providers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/list_remote_servers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List servers

List all MCP servers with pagination and optional sorting. Returns 30 results per page. Servers include sponsors (no slug) and community/official entries (with slug). Paginate by incrementing page; total_servers indicates the full catalog size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (30 results per page). |
| `sort` | string | No | Sort order for listings. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/list_servers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sort":"<string>"}'
```

### Search servers

Search for MCP servers by keyword. Returns paginated results matching the query against server names and descriptions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-mcpservers-org-api-6734cdd4/search_servers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```