PhenomlDocs
phenoml.comGet API keys

Create MCP server

POST/tools/mcp-server/create

Creates a new MCP server

RequiresBearerauthentication

Body parameters

namestringrequired

Name of the MCP server

mcp_server_urlstringrequired

URL of the MCP server

Returns  

Successfully created MCP server

Response fields

successbooleanoptional

Whether the operation succeeded

messagestringoptional

Status message

dataobjectoptional

Single MCP server (returned by GET /tools/mcp-server/{mcp_server_id}).

idstringoptional

ID of the MCP server

namestringoptional

Name of the MCP server

descriptionstringoptional

Description of the MCP server

mcp_server_urlstringoptional

URL of the MCP server

mcp_serversobject[]optional

List of MCP servers. Returned by /tools/mcp-server/create (the newly created server) and /tools/mcp-server/list (all servers).

idstringoptional

ID of the MCP server

namestringoptional

Name of the MCP server

descriptionstringoptional

Description of the MCP server

mcp_server_urlstringoptional

URL of the MCP server

mcp_server_toolsobject[]optional

Tools loaded from the MCP server. Returned by /tools/mcp-server/create alongside the server record, since tool discovery happens at create time.

idstringoptional

ID of the MCP server tool

namestringoptional

Name of the MCP server tool

descriptionstringoptional

Description of the MCP server tool

input_schemaobjectoptional

Input schema of the MCP server tool

mcp_server_idstringoptional

ID of the MCP server that the tool belongs to

mcp_server_urlstringoptional

URL of the MCP server

POSTRequest
curl -X POST 'https://experiment.app.pheno.ml/tools/mcp-server/create' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "My MCP Server",
  "mcp_server_url": "https://mcp.example.com"
}'
200 OKResponse
{
  "success": true,
  "message": "Successfully created MCP server",
  "data": {
    "id": "123",
    "name": "My MCP Server",
    "description": "My MCP Server is a server that provides MCP services",
    "mcp_server_url": "https://mcp.example.com"
  },
  "mcp_servers": [
    {
      "id": {},
      "name": {},
      "description": {},
      "mcp_server_url": {}
    }
  ],
  "mcp_server_tools": [
    {
      "id": "123",
      "name": "My MCP Server Tool",
      "description": "My MCP Server Tool is a tool that provides MCP services",
      "input_schema": {
        "name": "string",
        "age": "number"
      },
      "mcp_server_id": "123",
      "mcp_server_url": "https://mcp.example.com"
    }
  ]
}