Connections API

Base URL: http://localhost:8000/api/connections

List connections

GET /api/connections

curl http://localhost:8000/api/connections

Response 200 OK

[
  {
    "name": "notion",
    "command": "npx",
    "args": ["-y", "mcp-notion-server"],
    "env": {"NOTION_TOKEN": "secret_xxx"}
  }
]

---

Create connection

POST /api/connections
Content-Type: application/json

curl -X POST http://localhost:8000/api/connections \
  -H "Content-Type: application/json" \
  -d '{"name": "notion", "command": "npx", "args": ["-y", "mcp-notion-server"], "env": {"NOTION_TOKEN": "secret_xxx"}}'

Body

{
  "name": "notion",
  "command": "npx",
  "args": ["-y", "mcp-notion-server"],
  "env": {"NOTION_TOKEN": "secret_xxx"}
}

Response 201 Created — returns the created connection object.

Errors

Code	Reason
409	A connection with that name already exists

---

Get connection

GET /api/connections/{name}

curl http://localhost:8000/api/connections/notion

Response 200 OK

{
  "name": "notion",
  "command": "npx",
  "args": ["-y", "mcp-notion-server"],
  "env": {"NOTION_TOKEN": "secret_xxx"}
}

Errors

Code	Reason
404	Connection not found

---

Update connection

PUT /api/connections/{name}
Content-Type: application/json

curl -X PUT http://localhost:8000/api/connections/notion \
  -H "Content-Type: application/json" \
  -d '{"name": "notion", "command": "npx", "args": ["-y", "mcp-notion-server"], "env": {"NOTION_TOKEN": "secret_new"}}'

Body — same schema as POST.

Response 200 OK — returns the updated connection object.

Errors

Code	Reason
404	Connection not found

---

Delete connection

DELETE /api/connections/{name}

curl -X DELETE http://localhost:8000/api/connections/notion

Response 204 No Content

Errors

Code	Reason
404	Connection not found