Create Mcp

Create a new MCP entity.

This endpoint will connect to the MCP server, fetch available tools,
and validate that the specified tool_name exists.

Parameters:

  • name: MCP name
  • url: MCP server URL
  • tool_name: Name of the specific tool to fetch from MCP server
  • network_access: Network access level (must be 'remote')
  • headers: Optional authentication headers
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Creates an MCP entity. SUPERWISE connects to the MCP server at url, fetches its available tools, and stores their schemas in tool_schemas. network_access must be remote, and headers carries any authentication headers.

When to use it

Use it to give agents access to the tools on an MCP server. Check the server first with Test MCP connectivity.

Required parameters

  • name (body): the MCP name, 1 to 255 characters.
  • url (body): the MCP server URL.

Optional body fields: description, network_access, headers, params.

Response

A successful call returns 201 Created with the MCP object: id, name, url, network_access, tool_schemas, and timestamps. A 502 means SUPERWISE could not connect to the MCP server.

Related: Test MCP connectivity, List MCP tools, Get an MCP tool, Delete an MCP tool

Body Params

Base MCP schema with common fields.

string
required
length between 1 and 255

MCP name

string
required
length ≥ 1

MCP server URL

const
enum
Defaults to remote

Network access level

Allowed:
object | null

Authentication headers

object | null

Additional query parameters

Responses

400

Invalid request or tool not found in MCP server

422

Validation error (malformed request)

500

Internal server error

502

MCP server connection error

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json