# Mcpservers — 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.

> 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.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.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.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.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.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.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.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.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.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.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>"}'
```