Agents

Upsert MCP server configuration

Add or update an MCP server configuration. If the agent already has a MCP server with the specified name it is updated, otherwise it is added.

put/api/agents/{agent}/mcp/{name}

Request

  • Base URL: https://docs.weavy.com (the document declares no server; this is the origin it was published from)
  • URL: https://docs.weavy.com/api/agents/{agent}/mcp/{name}
  • Auth: none declared

Path parameters

agentstring required

Agent identifier (id or uid).

namestring required

MCP server name.

Request body

namestring nullable required

A name for the MCP server, used to identify it in tool calls.

urlstring uri nullable required

The URL for the MCP server.

descriptionstring nullable

Optional description of the MCP server, used to provide more context.

allowed_toolsstring[] nullable

List of allowed tool names.

approval_modestring nullable

Specifies whether the MCP server's tools require approval. Can be one of always or never.

headersobject nullable

Optional HTTP headers to send to the MCP server. Use for authentication or other purposes.

Response

OK

namestring nullable

The name of the remote MCP server.

urlstring nullable

The URL for the MCP server.

descriptionstring nullable

Optional description for the MCP server, used to provide more context.

allowed_toolsstring[] nullable

List of allowed tool names.

approval_modestring nullable

Specifies whether the MCP server's tools require approval. Can be one of always or never.

headersobject nullable

Optional HTTP headers to send to the MCP server. Use for authentication or other purposes.

Changes

No recorded changes to this operation across all 1 revision of this API.