---
title: "codespar mcp-servers"
description: "Tenant MCP servers: register, validate, list, patch a tool, sweep platform fees"
---

Tenant MCP servers: register, validate, list, patch a tool, sweep platform fees

8 commands in `@codespar/cli 0.16.0`.

Each one prints what its operation answered. [What a command prints](/docs/cli/reference#what-a-command-prints) has the rule, and [Configuration](/docs/cli/config#what-a-script-gets-when-a-command-fails) has the exit codes and the shape of a failure.

### `codespar mcp-servers validate`

Connect to an upstream MCP server and list its tools

```bash
codespar mcp-servers validate --input '{"upstream_url":"https://example.com/hook","auth":{"header":"string","value":"string"}}'
```

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |
| `-i, --input <json>` | Request body as a JSON string |
| `-f, --input-file <path>` | Request body from a JSON file |

`POST /v1/mcp-servers/validate` · [parameters, responses and refusals](/docs/api/reference/mcp-servers#post-v1mcp-serversvalidate)

### `codespar mcp-servers list`

List this project's MCP servers

```bash
codespar mcp-servers list
```

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |

`GET /v1/mcp-servers` · [parameters, responses and refusals](/docs/api/reference/mcp-servers#get-v1mcp-servers)

### `codespar mcp-servers create`

Register a monetized MCP server and price its tools

```bash
codespar mcp-servers create --input-file body.json
```

```json title="body.json"
{
  "slug": "example",
  "name": "Example",
  "description": "string",
  "overview_md": "string",
  "category": "string",
  "upstream_url": "https://example.com/hook",
  "consumer_id": "csm_0000000000000000",
  "upstream_auth": {
    "header": "string",
    "value": "string"
  },
  "platform_fee_bps": 0,
  "tools": [
    {
      "tool_name": "Example",
      "description": "string",
      "price": "string"
    }
  ]
}
```

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |
| `-i, --input <json>` | Request body as a JSON string |
| `-f, --input-file <path>` | Request body from a JSON file |

`POST /v1/mcp-servers` · [parameters, responses and refusals](/docs/api/reference/mcp-servers#post-v1mcp-servers)

### `codespar mcp-servers get`

Read one MCP server with its priced tools

```bash
codespar mcp-servers get obj_0000000000000000
```

| argument | what it is |
|---|---|
| `<id>` | String. |

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |

`GET /v1/mcp-servers/{id}` · [parameters, responses and refusals](/docs/api/reference/mcp-servers#get-v1mcp-serversid)

### `codespar mcp-servers delete`

Delete an MCP server and its priced tools

```bash
codespar mcp-servers delete obj_0000000000000000
```

| argument | what it is |
|---|---|
| `<id>` | String. |

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |

`DELETE /v1/mcp-servers/{id}` · [parameters, responses and refusals](/docs/api/reference/mcp-servers#delete-v1mcp-serversid)

### `codespar mcp-servers update`

Update an MCP server's listing metadata or its active flag

```bash
codespar mcp-servers update obj_0000000000000000 --input '{"name":"Example","description":"string","overview_md":"string","category":"string","active":true}'
```

| argument | what it is |
|---|---|
| `<id>` | String. |

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |
| `-i, --input <json>` | Request body as a JSON string |
| `-f, --input-file <path>` | Request body from a JSON file |

`PATCH /v1/mcp-servers/{id}` · [parameters, responses and refusals](/docs/api/reference/mcp-servers#patch-v1mcp-serversid)

### `codespar mcp-servers tools`

Reprice one tool, or turn it off

```bash
codespar mcp-servers tools obj_0000000000000000 string --input '{"price":"string","active":true}'
```

| argument | what it is |
|---|---|
| `<id>` | String. |
| `<tool>` | String. |

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |
| `-i, --input <json>` | Request body as a JSON string |
| `-f, --input-file <path>` | Request body from a JSON file |

`PATCH /v1/mcp-servers/{id}/tools/{tool}` · [parameters, responses and refusals](/docs/api/reference/mcp-servers#patch-v1mcp-serversidtoolstool)

### `codespar mcp-servers platform-fees-sweep`

Move accrued platform fees to the organization's wallet now

```bash
codespar mcp-servers platform-fees-sweep
```

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |

`POST /v1/mcp-servers/platform-fees/sweep` · [parameters, responses and refusals](/docs/api/reference/mcp-servers#post-v1mcp-serversplatform-feessweep)