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. 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 and secret. OAuth is not yet supported.

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