---
title: "MCP tool call"
method: POST
path: "/api/mcp"
---

# MCP tool call

`POST /api/mcp`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/mcp`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `Authorization`

JSON-RPC 2.0 request to the MCP server. Supports tools for 3D avatar management, model validation, inspection, and optimization.

## Request body

- object
  - `jsonrpc` '2.0', required
  - `id` union
    - string
    - number
  - `method` string, required: MCP method name, e.g. "tools/call" or "initialize".
  - `params` object: Method-specific parameters.

## Response `200`

JSON-RPC 2.0 response

## Other responses

- `401`: Unauthorized — missing or invalid token
- `402`: Payment Required
- `429`: Rate limited

---

[API](https://skmtc.dev/three/apis/three-ws-api.md) · [All operations](https://skmtc.dev/three/apis/three-ws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/three/apis/three-ws-api/revisions/dbc5e3a81b79?raw)