MCP Servers

Endpointhttps://api.neuratel.ai

Model Context Protocol server registrations + workspace credential vault. Connect external tool servers and reuse stored auth across them.

List Auth Connections

GET

https://api.neuratel.ai

/v1/auth-connections

List Auth Connections › Responses

200

Successful Response

object[] · required

Create Auth Connection

POST

https://api.neuratel.ai

/v1/auth-connections

Create Auth Connection › Request Body

Create a new credential vault entry. For ``kind="bearer"``: pass the raw token in ``token``. For ``kind="headers"``: pass a dict in ``headers``. Exactly one of the two must be supplied; ``_kind_secret_match`` raises a 422 with field-level info before the request reaches the service.

name

string · minLength: 1 · maxLength: 255 · required

kind

string · enum · required

Enum values:

bearer

headers

Create Auth Connection › Responses

Successful Response

Response shape — secret value never leaves the server. For ``kind="bearer"`` the response sets ``has_token=True`` once a token is stored; for ``kind="headers"`` ``header_keys`` lists the keys (never values).

id

string · uuid · required

organization_id

string · uuid · required

name

string · required

kind

string · enum · required

Enum values:

bearer

headers

has_token

boolean

Default: false

header_keys

string[]

Update Auth Connection

PUT

https://api.neuratel.ai

/v1/auth-connections/{auth_id}

Update Auth Connection › path Parameters

auth_id

string · uuid · required

Auth connection id

Update Auth Connection › Request Body

Update Auth Connection › Responses

Successful Response

id

string · uuid · required

organization_id

string · uuid · required

name

string · required

kind

string · enum · required

Enum values:

bearer

headers

has_token

boolean

Default: false

header_keys

string[]

Delete Auth Connection

DELETE

https://api.neuratel.ai

/v1/auth-connections/{auth_id}

Delete Auth Connection › path Parameters

auth_id

string · uuid · required

Auth connection id

Delete Auth Connection › Responses

Successful Response

No data returned

List MCP Servers

GET

https://api.neuratel.ai

/v1/mcp-servers

List MCP Servers › Responses

200

Successful Response

object[] · required

Create MCP Server

POST

https://api.neuratel.ai

/v1/mcp-servers

Create MCP Server › Request Body

name

string · minLength: 1 · maxLength: 255 · required

server_url

string · uri · minLength: 1 · required

timeout_seconds

integer · min: 1 · max: 300

Default: 30

Create MCP Server › Responses

Successful Response

id

string · uuid · required

organization_id

string · uuid · required

name

string · required

server_url

string · required

timeout_seconds

integer · required

POST/v1/mcp-servers

curl --request POST \
  --url https://api.neuratel.ai/v1/mcp-servers \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "description": "string",
  "server_url": "https://www.example.com/path/to/resource",
  "timeout_seconds": 30,
  "auth_connection_id": "00000000-0000-0000-0000-000000000000"
}
'

shell

Example Request Body

{
  "name": "name",
  "description": "string",
  "server_url": "https://www.example.com/path/to/resource",
  "timeout_seconds": 30,
  "auth_connection_id": "00000000-0000-0000-0000-000000000000"
}

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "string",
  "server_url": "server_url",
  "timeout_seconds": 0,
  "auth_connection_id": "00000000-0000-0000-0000-000000000000",
  "last_test_status": "string",
  "last_test_at": "string",
  "last_test_error": "string",
  "created_at": "string",
  "updated_at": "string"
}

json

application/json

Update MCP Server

PUT

https://api.neuratel.ai

/v1/mcp-servers/{server_id}

Update MCP Server › path Parameters

server_id

string · uuid · required

MCP server id

Update MCP Server › Request Body

Update MCP Server › Responses

Successful Response

id

string · uuid · required

organization_id

string · uuid · required

name

string · required

server_url

string · required

timeout_seconds

integer · required

PUT/v1/mcp-servers/{server_id}

curl --request PUT \
  --url https://api.neuratel.ai/v1/mcp-servers/:server_id \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "string",
  "description": "string",
  "server_url": "https://www.example.com/path/to/resource",
  "timeout_seconds": 1,
  "auth_connection_id": "00000000-0000-0000-0000-000000000000"
}
'

shell

Example Request Body

{
  "name": "string",
  "description": "string",
  "server_url": "https://www.example.com/path/to/resource",
  "timeout_seconds": 1,
  "auth_connection_id": "00000000-0000-0000-0000-000000000000"
}

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "name": "name",
  "description": "string",
  "server_url": "server_url",
  "timeout_seconds": 0,
  "auth_connection_id": "00000000-0000-0000-0000-000000000000",
  "last_test_status": "string",
  "last_test_at": "string",
  "last_test_error": "string",
  "created_at": "string",
  "updated_at": "string"
}

json

application/json

Delete MCP Server

DELETE

https://api.neuratel.ai

/v1/mcp-servers/{server_id}

Delete MCP Server › path Parameters

server_id

string · uuid · required

MCP server id

Delete MCP Server › Responses

Successful Response

No data returned

Validate an MCP server config without persisting

POST

https://api.neuratel.ai

/v1/mcp-servers/validate

Backs the create modal's Test-then-Save flow.

Pass inline_headers to test before persisting an auth connection, or auth_connection_id to reuse an existing vault entry.

Validate an MCP server config without persisting › Request Body

Probe a server config WITHOUT persisting it. Use either ``auth_connection_id`` to reuse a stored credential, OR ``inline_headers`` for a one-shot test (the create modal uses inline headers before the auth connection has been created). If both are supplied ``inline_headers`` takes priority.

server_url

string · uri · minLength: 1 · required

timeout_seconds

integer · min: 1 · max: 300

Default: 20

Validate an MCP server config without persisting › Responses

Successful Response

Outcome of a connect + ``tools/list`` probe.

success

boolean · required

object[]

tool_count

integer

Default: 0

POST/v1/mcp-servers/validate

curl --request POST \
  --url https://api.neuratel.ai/v1/mcp-servers/validate \
  --header 'Content-Type: application/json' \
  --data '
{
  "server_url": "https://www.example.com/path/to/resource",
  "timeout_seconds": 20,
  "auth_connection_id": "00000000-0000-0000-0000-000000000000",
  "inline_headers": {
    "key": "string"
  }
}
'

shell

Example Request Body

{
  "server_url": "https://www.example.com/path/to/resource",
  "timeout_seconds": 20,
  "auth_connection_id": "00000000-0000-0000-0000-000000000000",
  "inline_headers": {
    "key": "string"
  }
}

json

Example Responses

{
  "success": true,
  "server_info": {},
  "tools": [
    {
      "name": "name",
      "description": "",
      "input_schema": {}
    }
  ],
  "tool_count": 0,
  "error": "string",
  "error_type": "string"
}

json

application/json

Test connection of a saved MCP server

POST

https://api.neuratel.ai

/v1/mcp-servers/{server_id}/test

Test connection of a saved MCP server › path Parameters

server_id

string · uuid · required

MCP server id

Test connection of a saved MCP server › Responses

Successful Response

Outcome of a connect + ``tools/list`` probe.

success

boolean · required

object[]

tool_count

integer

Default: 0

List tools from a saved MCP server

GET

https://api.neuratel.ai

/v1/mcp-servers/{server_id}/tools

List tools from a saved MCP server › path Parameters

server_id

string · uuid · required

MCP server id

List tools from a saved MCP server › Responses

Successful Response

Outcome of a connect + ``tools/list`` probe.

success

boolean · required

object[]

tool_count

integer

Default: 0

Execute a tool on a saved MCP server

POST

https://api.neuratel.ai

/v1/mcp-servers/{server_id}/tools/{tool_name}/execute

Execute a tool on a saved MCP server › path Parameters

server_id

string · uuid · required

MCP server id

tool_name

string · required

Tool name

Execute a tool on a saved MCP server › Request Body

object

Execute a tool on a saved MCP server › Responses

Successful Response

success

boolean · required

tool_name

string · required

object

array

is_error

boolean

Default: false

Numbers Voices