> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudhumans.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete an MCP server

> Remove a server and its stored credential. Agents configured to use it stop being able to call its tools, so check what references the slug before deleting. Servers CloudHumans owns cannot be deleted.



## OpenAPI

````yaml /api-reference/specs/claudia/v1.json delete /v1/tenants/{tenant}/mcp-servers/{id}
openapi: 3.0.1
info:
  title: Claudia API
  version: 1.0.0
servers:
  - url: https://api.cloudhumans.com/claudia
    description: Production
  - url: https://api.cloudhumans.com/claudia/staging
    description: Staging
security:
  - bearerAuth: []
tags:
  - name: MCP Servers
    description: >-
      The MCP servers your agents can call tools on. Registering one here is
      what makes its tools selectable in an agent; the credentials it needs are
      stored encrypted and never read back.
  - name: Knowledge Base Content
    description: Read, search and edit the content that answers your customers.
  - name: Content Quality
    description: Rewrites proposed for content that is answering your customers badly.
  - name: Playground
    description: >-
      Talk to one of your agents as if you were a customer, without touching a
      real conversation.
  - name: Project Settings
    description: >-
      Read and change how a ClaudIA project behaves — the settings screens of
      the ClaudIA app, as an API.
  - name: Content Improvements
    description: Answers Claudia proposes for questions your content does not cover yet.
  - name: Knowledge Bases
    description: The knowledge bases your account can manage.
  - name: Content Sources
    description: The sites Claudia crawls to keep a knowledge base in sync.
paths:
  /v1/tenants/{tenant}/mcp-servers/{id}:
    delete:
      tags:
        - MCP Servers
      summary: Delete an MCP server
      description: >-
        Remove a server and its stored credential. Agents configured to use it
        stop being able to call its tools, so check what references the slug
        before deleting. Servers CloudHumans owns cannot be deleted.
      operationId: deleteMcpServer
      parameters:
        - name: tenant
          in: path
          description: >-
            Tenant whose MCP servers you are managing. Get it from the
            backoffice `GET /auth/v1/me/claudia-projects`, which answers with
            the tenant your credentials cover. A tenant your credentials do not
            cover is indistinguishable from one that does not exist.
          required: true
          schema:
            type: string
        - name: id
          in: path
          description: MCP server to operate on, as returned by listMcpServers.
          required: true
          schema:
            type: string
      responses:
        '204':
          description: The server is gone.
          content:
            '*/*':
              schema:
                type: object
        '400':
          description: The request could not be answered as written.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing, expired or invalid credentials.
        '403':
          description: The credentials hold no account allowed to manage this content.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            No such resource, or none these credentials can reach — the two are
            deliberately indistinguishable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: This server is owned by CloudHumans and cannot be deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit applied by the API gateway. Back off and retry.
components:
  schemas:
    Error:
      required:
        - error
      type: object
      properties:
        error:
          type: string
          description: What went wrong.
          example: 'Forbidden: token holds no claim for the requested account'
      description: Something the caller needs to fix.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````