Register a remote MCP server

curl -X POST https://ah-api.merge.dev/api/v1/connectors/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Acme MCP",
  "url": "https://mcp.acme.com/mcp",
  "auth": {
    "type": "none"
  }
}'

{
  "id": "084fce8e-43d3-472a-8227-e28553e73aa0",
  "name": "Acme MCP",
  "slug": "acme_mcp",
  "description": "",
  "source_url": "https://mcp.acme.com/mcp",
  "logo_url": "https://mintcdn.com/mcp/4ZXF1PrDkEaJvXpn/mcp.png?fit=max&auto=format&n=4ZXF1PrDkEaJvXpn&q=85&s=532f106faedf9079b75d2bdb69426588",
  "categories": [],
  "auth_options": [],
  "tools": [
    {
      "name": "search_docs",
      "description": "Search the Acme documentation corpus.",
      "credit_type": "simple"
    },
    {
      "name": "get_page",
      "description": "Fetch a single documentation page by id.",
      "credit_type": "simple"
    }
  ],
  "source": "external_mcp"
}

Registers a remote MCP server as a connector. For none and secret, Merge completes the MCP handshake against the server before anything is written, so either a connector exists with its tools discovered or nothing does.

auth.type accepts none, secret and oauth.

With secret, set auth.auth_scope to INDIVIDUAL to have each registered user enter their own full header value through Link, including any Bearer prefix.

With oauth, each registered user authorizes through Link. Every field in auth.oauth is optional. Merge reads missing endpoints from the server’s OAuth authorization server metadata, following its protected resource metadata (RFC 9728) when the server delegates OAuth to a separate identity provider, and, without a client_id, registers a client through the server’s dynamic client registration endpoint. The connector is created with no tools, because the server lists them only to an authorized user.

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Request

This endpoint expects an object.

namestringRequired<=100 characters

Display name for the connector.

urlstringRequiredformat: "uri"

HTTPS URL of the remote MCP server. Immutable once set.

slugstringOptional

Identifier for the connector. Lowercase letters, digits and underscores. Derived from name when omitted.

headersmap from strings to stringsOptional

Additional non-secret headers sent on every request. Write-only: the caller is the system of record for header state.

authobjectOptional

Defaults to {"type": "none"}.

Response

idstring

Unique identifier for the Connector

namestring

Name of the Connector

slugstring

Slug identifier for the Connector

descriptionstring

Description of what the Connector does

source_urlstring or null

URL to the Connector's source website

logo_urlstring

URL to the Connector's logo image

categorieslist of strings or null

Categories this connector belongs to

auth_optionslist of objectsRead-only

Authentication options available for this connector

toolslist of objectsRead-only

List of available tools for this connector. By default each tool includes only name, description, and credit_type; pass include_tool_details=true on the detail endpoint to also include input_schema, output_schema, annotations, scopes, and endpoints.

Errors

409

Conflict Error