Skip to main content
PUT
/
api
/
v1
/
mcp
/
agents
/
{agent_id}
/
servers
/
{server_id}
Update Mcp Server
curl --request PUT \
  --url https://agent-studio.thena.ai/api/v1/mcp/agents/{agent_id}/servers/{server_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "url": "<string>",
  "auth_config": {},
  "health_check_url": "<string>",
  "tool_discovery_endpoint": "<string>",
  "status": "<string>",
  "is_enabled": true,
  "token_expires_at": "2023-11-07T05:31:56Z"
}
'
{
  "agent_id": "123e4567-e89b-12d3-a456-426614174001",
  "auth_config": {
    "client_id": "our_dynamically_registered_client_id",
    "type": "oauth2"
  },
  "created_at": "2023-01-01T00:00:00Z",
  "health_check_url": "https://api.salesforce.com/mcp/health",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "last_health_check": "2023-01-01T00:00:00Z",
  "name": "Salesforce MCP",
  "status": "connected",
  "updated_at": "2023-01-01T00:00:00Z",
  "url": "https://api.salesforce.com/mcp"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
agent_id
string
required
​
server_id
string<uuid>
required

Body

application/json

Model for updating an MCP server configuration.

​
name
string | null

Updated name

​
url
string | null

Updated URL

​
auth_config
Auth Config · object

Updated auth configuration

​
health_check_url
string | null

Updated health check URL

​
tool_discovery_endpoint
string | null

Updated tool discovery endpoint

​
status
string | null

Updated status

​
is_enabled
boolean | null

Whether the MCP server should be enabled

​
token_expires_at
string<date-time> | null

The timestamp when the OAuth access token expires

Response

Successful Response

Model for an MCP server configuration.

​
name
string
required

Display name of the MCP server

​
url
string
required

URL of the MCP server

​
id
string<uuid>
required

Unique identifier for the MCP server

​
agent_id
string<uuid>
required

ID of the agent this MCP server belongs to

​
created_at
string<date-time>
required

When the MCP server was configured

​
updated_at
string<date-time>
required

When the MCP server was last updated

​
auth_config
Auth Config · object

Authentication configuration for the MCP server

​
tool_discovery_endpoint
string | null
default:/tools

The endpoint path for tool discovery, defaults to /tools

​
health_check_url
string | null

URL for health check endpoint

​
status
string
default:disconnected

Connection status: 'connected', 'disconnected', 'error'

​
last_health_check
string<date-time> | null

Timestamp of the last health check

​
is_enabled
boolean
default:true

Whether the MCP server is enabled for use by the agent

​
deleted_at
string<date-time> | null

Timestamp when the server was soft-deleted

​
token_expires_at
string<date-time> | null

The timestamp when the OAuth access token expires