MCP configs
Update
Replace an MCP config's metadata and JSON content in your Nairi organization. Update the server definition without changing agent attachments.
PUT /api/public/v1/artifacts/mcp-configs/{config_id}Request body
Prop
Type
Example
curl -X PUT https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/CONFIG_ID \
-H "Authorization: Bearer $NAIRI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Updated Database MCP",
"description": "Updated description",
"content": "{\"mcpServers\": {...}}",
"is_sensitive": true
}'const res = await fetch(
`https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/${configId}`,
{
method: "PUT",
headers: {
Authorization: `Bearer ${process.env.NAIRI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
title: "Updated Database MCP",
description: "Updated description",
content: '{"mcpServers": {...}}',
is_sensitive: true,
}),
},
);
const data = await res.json();require "net/http"
require "json"
require "uri"
uri = URI("https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/#{config_id}")
req = Net::HTTP::Put.new(uri)
req["Authorization"] = "Bearer #{ENV['NAIRI_API_KEY']}"
req["Content-Type"] = "application/json"
req.body = {
title: "Updated Database MCP",
description: "Updated description",
content: '{"mcpServers": {...}}',
is_sensitive: true,
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
data = JSON.parse(res.body)import os
import requests
res = requests.put(
f"https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/{config_id}",
headers={
"Authorization": f"Bearer {os.environ['NAIRI_API_KEY']}",
"Content-Type": "application/json",
},
json={
"title": "Updated Database MCP",
"description": "Updated description",
"content": '{"mcpServers": {...}}',
"is_sensitive": True,
},
)
data = res.json()package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
)
func main() {
configID := os.Getenv("CONFIG_ID")
body, _ := json.Marshal(map[string]any{
"title": "Updated Database MCP",
"description": "Updated description",
"content": `{"mcpServers": {...}}`,
"is_sensitive": true,
})
req, _ := http.NewRequest(
"PUT",
"https://api.nairi.ai/api/public/v1/artifacts/mcp-configs/"+configID,
bytes.NewReader(body),
)
req.Header.Set("Authorization", "Bearer "+os.Getenv("NAIRI_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
raw, _ := io.ReadAll(res.Body)
var data map[string]any
json.Unmarshal(raw, &data)
fmt.Println(data)
}Response
{
"id": "amc_01KRB3E9725XECM1824B8B2XF2",
"title": "Updated Database MCP",
"description": "Updated description",
"is_sensitive": true,
"created_at": "2026-04-12T18:45:12.000Z",
"updated_at": "2026-04-12T18:50:00.000Z"
}Get
Fetch a single MCP config including its full JSON content from your Nairi organization by ID. The content field is omitted when the config is sensitive.
Delete
Permanently delete an MCP config from your Nairi organization. Fails if the config is still assigned to any agent — unassign first, then retry.