MCP Gateway
ApiLocal tools

Create a tool on a LOCAL server

Create a tool on a LOCAL server with embedding and poisoning scan.

POST
/api/v1/servers/{server_id}/tools

Path Parameters

server_id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://loading/api/v1/servers/497f6eca-6276-4993-bfeb-53cbbbba6f08/tools" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "description": "string"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "input_schema": {},
  "has_embedding": true,
  "enrichment_data": {},
  "origin_type": "rest",
  "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa",
  "entrypoint": "string",
  "script_metadata": {},
  "has_overrides": false,
  "override_description": "string",
  "override_input_schema": {},
  "override_enrichment_data": {}
}
Empty
Empty
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Bulk sync tools on a LOCAL server

Declarative sync: the client sends the desired tool state, and the gateway creates, updates, or deletes tools to reconcile. All changes are atomic (single transaction). Tool names must be unqualified. Only affects LOCAL-origin tools; script-origin tools are left untouched.

Delete a tool from a LOCAL server

Delete a tool from a LOCAL server.