MCP Servers

Get list of available MCP servers

get

Get MCP Servers

Retrieve MCP servers. This endpoint supports both authenticated and unauthenticated access:

• Authenticated: Returns MCP servers with isActive status indicating whether each server is active for the authenticated user

• Unauthenticated: Returns a public list of MCP servers without the isActive field

Inactive servers are also listed in the authenticated response but trying to use them will fail. You can encourage users to activate the servers in their BlueNexus account.

Usage Examples

Public access (no authentication)

GET /v1/mcps - Returns basic server list

GET /v1/mcps?page=2&limit=10 - Second page, 10 items per page

Authenticated access

GET /v1/mcps with Authorization: Bearer <token> header - Returns servers with isActive status

Required scope (when authenticated): mcp-proxy

Authorizations

access-token

AuthorizationstringRequired

Enter JWT access token

Query parameters

pagenumber · min: 1Optional

Page number (1-based)

Default: 1Example: 1

limitnumber · min: 1 · max: 100Optional

Number of MCP servers to return (1-100)

Default: 20Example: 20

Responses

200

Paginated list of MCP servers. Includes isActive status if authenticated.

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

get

/api/v1/mcps

HTTPcURLJavaScriptPython

GET /api/v1/mcps HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "slug": "context7",
      "label": "Context7",
      "description": "Up-to-date code documentation for LLMs and AI code editors",
      "isActive": true,
      "url": "https://api.bluenexus.ai/api/v1/mcps/context7"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "pages": 10,
    "hasNext": true,
    "hasPrev": false
  }
}

Get tools list from an MCP server

get

Automatically sends a tools/list JSON-RPC request to the specified MCP server to retrieve available tools.

Authorizations

access-token

AuthorizationstringRequired

Enter JWT access token

Path parameters

mcpServerSlugstringRequired

MCP Server Slug

Example: context7

Responses

200

List of available tools from the MCP server

application/json

401

Unauthorized

application/json

403

Forbidden, if the authenticated user doesn't have access to this server.

application/json

404

MCP Server not found

application/json

500

Internal server error

application/json

get

/api/v1/mcps/{mcpServerSlug}/tools

HTTPcURLJavaScriptPython

GET /api/v1/mcps/{mcpServerSlug}/tools HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "tools": [
    {
      "name": "get_weather",
      "description": "Get current weather information",
      "inputSchema": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string"
          }
        }
      }
    }
  ]
}

Call a specific tool on an MCP server

post

Executes a specific tool with provided arguments on the specified MCP server.

Authorizations

access-token

AuthorizationstringRequired

Enter JWT access token

Path parameters

mcpServerSlugstringRequired

MCP Server Slug

Example: context7

Body

application/json

Request body to call a specific tool on an MCP server

namestringRequired

Name of the tool to call

Example: resolve-library-id

Responses

200

Result of the tool call

application/json

401

Unauthorized

application/json

403

Forbidden, if the authenticated user doesn't have access to this server.

application/json

404

MCP Server not found

application/json

500

Internal server error

application/json

post

/api/v1/mcps/{mcpServerSlug}/tools/call

HTTPcURLJavaScriptPython

POST /api/v1/mcps/{mcpServerSlug}/tools/call HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "name": "resolve-library-id",
  "arguments": {
    "libraryName": "MCP"
  }
}

{
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Tool execution result..."
      }
    ]
  }
}

Open SSE stream for MCP server notifications

get

Open a Server-Sent Events (SSE) stream to receive JSON-RPC notifications and requests from the MCP server.

Required scope: mcp-proxy

Authorizations

access-token

AuthorizationstringRequired

Enter JWT access token

Path parameters

mcpServerSlugstringRequired

MCP Server Slug

Example: context7

Header parameters

Mcp-Session-IdstringOptional

Optional session identifier for MCP session management

AcceptstringOptional

Must include text/event-stream to receive SSE stream

Responses

200

SSE stream of JSON-RPC messages

text/event-stream

401

Unauthorized

application/json

403

Forbidden, if the authenticated user doesn't allow the use of this server.

text/event-stream

404

MCP Server not found or session not found

text/event-stream

500

Internal server error

application/json

get

/api/v1/mcps/{mcpServerSlug}

HTTPcURLJavaScriptPython

GET /api/v1/mcps/{mcpServerSlug} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "event": "message",
  "data": {
    "jsonrpc": "2.0",
    "method": "notifications/message",
    "params": {
      "level": "info",
      "message": "Processing started"
    }
  },
  "id": "event-123",
  "retry": 3000
}

Send JSON-RPC request to MCP server

post

Send a JSON-RPC request to the MCP server and receive either a direct JSON response or an SSE stream.

Required scope: mcp-proxy

Authorizations

access-token

AuthorizationstringRequired

Enter JWT access token

Path parameters

mcpServerSlugstringRequired

MCP Server Slug

Example: context7

Header parameters

MCP-Protocol-VersionstringOptional

MCP protocol version

Mcp-Session-IdstringOptional

Optional session identifier for MCP session management

Body

application/json

A standard JSON-RPC request object

jsonrpcstring · enumRequired

JSON-RPC protocol version

Example: 2.0Possible values:

methodstringRequired

The name of the method to be invoked

Example: tools/list

paramsone ofOptional

Parameters for the method call, can be an object or array

Example: {"limit":10,"offset":0}

or

object[]Optional

idone ofRequired

Unique identifier for the request, can be string, number, or null (discouraged)

Example: req-123

stringOptional

or

numberOptional

or

nullOptional

Responses

200

JSON-RPC response

application/jsontext/event-stream

202

Request accepted, response will be sent via SSE stream

401

Unauthorized

application/json

403

Forbidden, if the authenticated user doesn't allow the use of this server.

application/jsontext/event-stream

404

MCP Server not found or session not found

application/jsontext/event-stream

500

Internal server error

application/json

post

/api/v1/mcps/{mcpServerSlug}

HTTPcURLJavaScriptPython

POST /api/v1/mcps/{mcpServerSlug} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "params": {
    "limit": 10,
    "offset": 0
  },
  "id": "req-123"
}

{
  "jsonrpc": "2.0",
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "description": "Get weather data"
      }
    ]
  },
  "error": {
    "code": -32602,
    "message": "Invalid params"
  },
  "id": "req-123"
}

Terminate MCP server session

delete

Explicitly terminates an active MCP server session. Clients should send this request when they no longer need a particular session to allow proper cleanup.

Required scope: mcp-proxy

Authorizations

access-token

AuthorizationstringRequired

Enter JWT access token

Path parameters

mcpServerSlugstringRequired

MCP Server Slug

Example: context7

Header parameters

Mcp-Session-IdstringRequired

Session identifier for the MCP session to terminate

Responses

204

Session terminated successfully

401

Unauthorized

application/json

403

Forbidden, if the authenticated user doesn't allow the use of this server.

application/json

404

MCP Server not found or session not found

application/json

500

Internal server error

application/json

delete

/api/v1/mcps/{mcpServerSlug}

HTTPcURLJavaScriptPython

DELETE /api/v1/mcps/{mcpServerSlug} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Mcp-Session-Id: text
Accept: */*

No content