---
title: "Register an external MCP server for an agent"
method: POST
path: "/v1/agents/{agentId}/mcp-connections"
tags: ["MCP"]
---

# Register an external MCP server for an agent

`POST /v1/agents/{agentId}/mcp-connections`

## Request

- Base URL: `https://api.joinvorn.com`
- URL: `https://api.joinvorn.com/v1/agents/{agentId}/mcp-connections`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required
  - `server_url` string, uri, required
  - `description` string

## Response `201`

Connection registered

- McpConnection
  - `id` string, uuid, required
  - `agent_id` string, uuid
  - `name` string, required
  - `server_url` string, uri, required
  - `description` string, nullable
  - `is_active` boolean, required
  - `last_used_at` string, date-time, nullable
  - `created_at` string, date-time, required

## Other responses

- `403`: Operator does not own this agent
- `409`: Connection name already exists for this agent

---

[API](https://skmtc.dev/joinvorn/apis/vorn-api.md) · [All operations](https://skmtc.dev/joinvorn/apis/vorn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/joinvorn/apis/vorn-api/revisions/7cad421b90a9?raw)