Create MCP Registry Server

curl --request POST \
  --url https://api.enkryptai.com/mcp-registry/add-server \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "saved_name": "my-filesystem-server",
  "server_version": "v1",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "server_name": "@modelcontextprotocol/server-filesystem",
  "description": "Filesystem access for MCP",
  "source_url": "https://github.com/modelcontextprotocol/servers",
  "source_version": "v0.6.2",
  "mcp_config": {
    "config": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/tmp"
      ]
    },
    "tools": {},
    "denied_tools": []
  }
}
'

{
  "message": "<string>",
  "data": {
    "saved_name": "<string>",
    "server_version": "<string>",
    "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "source_url": "<string>",
    "source_version": "<string>",
    "server_name": "<string>",
    "description": "<string>",
    "mcp_config": {
      "config": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "/tmp"
        ],
        "env": {
          "OPENAI_API_KEY": "sk-...",
          "LOG_LEVEL": "info"
        }
      },
      "oauth_config": {
        "enabled": true,
        "is_remote": true,
        "OAUTH_VERSION": "2.1",
        "OAUTH_GRANT_TYPE": "authorization_code",
        "OAUTH_CLIENT_ID": "<string>",
        "OAUTH_CLIENT_SECRET": "<string>",
        "OAUTH_TOKEN_URL": "<string>",
        "OAUTH_AUTHORIZATION_URL": "<string>",
        "OAUTH_REDIRECT_URI": "<string>",
        "OAUTH_AUDIENCE": "<string>",
        "OAUTH_ORGANIZATION": "<string>",
        "OAUTH_SCOPE": "read write",
        "OAUTH_RESOURCE": "<string>",
        "OAUTH_USE_PKCE": true,
        "OAUTH_CODE_CHALLENGE_METHOD": "S256",
        "OAUTH_TOKEN_EXPIRY_BUFFER": 300,
        "OAUTH_USE_BASIC_AUTH": true,
        "OAUTH_ENFORCE_HTTPS": true,
        "OAUTH_TOKEN_IN_HEADER_ONLY": true,
        "OAUTH_VALIDATE_SCOPES": true,
        "OAUTH_USE_MTLS": true,
        "OAUTH_CLIENT_CERT_PATH": "<string>",
        "OAUTH_CLIENT_KEY_PATH": "<string>",
        "OAUTH_CA_BUNDLE_PATH": "<string>",
        "OAUTH_REVOCATION_URL": "<string>",
        "OAUTH_ADDITIONAL_PARAMS": {},
        "OAUTH_CUSTOM_HEADERS": {}
      },
      "tools": {},
      "denied_tools": [
        "delete_*",
        {
          "name": "write_file",
          "reason": "destructive"
        }
      ],
      "input_guardrails_config": {
        "enabled": true,
        "guardrail_name": "<string>",
        "additional_config": {},
        "block": []
      },
      "output_guardrails_config": {
        "enabled": true,
        "guardrail_name": "<string>",
        "additional_config": {},
        "block": []
      }
    },
    "registry_id": "<string>",
    "registry_name": "<string>",
    "project_name": "<string>",
    "is_active": true,
    "is_sample": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "updated_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

POST

mcp-registry

add-server

curl --request POST \
  --url https://api.enkryptai.com/mcp-registry/add-server \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "saved_name": "my-filesystem-server",
  "server_version": "v1",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "server_name": "@modelcontextprotocol/server-filesystem",
  "description": "Filesystem access for MCP",
  "source_url": "https://github.com/modelcontextprotocol/servers",
  "source_version": "v0.6.2",
  "mcp_config": {
    "config": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/tmp"
      ]
    },
    "tools": {},
    "denied_tools": []
  }
}
'

{
  "message": "<string>",
  "data": {
    "saved_name": "<string>",
    "server_version": "<string>",
    "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "source_url": "<string>",
    "source_version": "<string>",
    "server_name": "<string>",
    "description": "<string>",
    "mcp_config": {
      "config": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "/tmp"
        ],
        "env": {
          "OPENAI_API_KEY": "sk-...",
          "LOG_LEVEL": "info"
        }
      },
      "oauth_config": {
        "enabled": true,
        "is_remote": true,
        "OAUTH_VERSION": "2.1",
        "OAUTH_GRANT_TYPE": "authorization_code",
        "OAUTH_CLIENT_ID": "<string>",
        "OAUTH_CLIENT_SECRET": "<string>",
        "OAUTH_TOKEN_URL": "<string>",
        "OAUTH_AUTHORIZATION_URL": "<string>",
        "OAUTH_REDIRECT_URI": "<string>",
        "OAUTH_AUDIENCE": "<string>",
        "OAUTH_ORGANIZATION": "<string>",
        "OAUTH_SCOPE": "read write",
        "OAUTH_RESOURCE": "<string>",
        "OAUTH_USE_PKCE": true,
        "OAUTH_CODE_CHALLENGE_METHOD": "S256",
        "OAUTH_TOKEN_EXPIRY_BUFFER": 300,
        "OAUTH_USE_BASIC_AUTH": true,
        "OAUTH_ENFORCE_HTTPS": true,
        "OAUTH_TOKEN_IN_HEADER_ONLY": true,
        "OAUTH_VALIDATE_SCOPES": true,
        "OAUTH_USE_MTLS": true,
        "OAUTH_CLIENT_CERT_PATH": "<string>",
        "OAUTH_CLIENT_KEY_PATH": "<string>",
        "OAUTH_CA_BUNDLE_PATH": "<string>",
        "OAUTH_REVOCATION_URL": "<string>",
        "OAUTH_ADDITIONAL_PARAMS": {},
        "OAUTH_CUSTOM_HEADERS": {}
      },
      "tools": {},
      "denied_tools": [
        "delete_*",
        {
          "name": "write_file",
          "reason": "destructive"
        }
      ],
      "input_guardrails_config": {
        "enabled": true,
        "guardrail_name": "<string>",
        "additional_config": {},
        "block": []
      },
      "output_guardrails_config": {
        "enabled": true,
        "guardrail_name": "<string>",
        "additional_config": {},
        "block": []
      }
    },
    "registry_id": "<string>",
    "registry_name": "<string>",
    "project_name": "<string>",
    "is_active": true,
    "is_sample": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "updated_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Authorizations

apikey

string

header

required

Body

application/json

saved_name

string

required

User-given name for the server, unique per project and version

Maximum string length: 32

Example:

"my-filesystem-server"

server_version

string

default:v1

Server version (v1, v2, etc.)

Example:

"v1"

is_active

boolean

default:true

Whether the server is enabled. Inactive servers are hidden from gateway resolution but not soft-deleted.

job_id

string<uuid> | null

MCP Hub server identifier (UUID). Optional — manually-configured servers may omit it.

Example:

"550e8400-e29b-41d4-a716-446655440000"

source_url

string | null

Source URL (e.g., GitHub link)

Example:

"https://github.com/modelcontextprotocol/servers"

source_version

string | null

Source version or commit hash

Example:

"v0.6.2"

server_name

string | null

Server package name

Example:

"@modelcontextprotocol/server-filesystem"

description

string | null

Human-readable server description

Example:

"Filesystem access for MCP"

mcp_config

object

MCP server configuration template. Shape mirrors a single entry of secure-mcp-gateway's mcp_configs.<id>.mcp_config[] array, so the registry server's mcp_config is directly consumable by the gateway runtime.

Show child attributes

Response

Registry server created successfully

message

string

Response message

data

object

Show child attributes

Get MCP Hub API Usage Summary Bulk-create MCP Registry Servers (atomic)

⌘I