Skip to main content
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": [],
    "enable_server_info_validation": true,
    "tool_guardrails_config": {
      "enabled": false,
      "guardrail_name": "",
      "block": []
    }
  }
}
'
{
  "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"
        ]
      },
      "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"
        }
      ],
      "enable_server_info_validation": true,
      "tool_guardrails_config": {
        "enabled": true,
        "guardrail_name": "<string>",
        "additional_config": {},
        "block": [
          "policy_violation"
        ]
      },
      "input_guardrails_config": {
        "enabled": true,
        "guardrail_name": "<string>",
        "additional_config": {},
        "block": [
          "policy_violation"
        ]
      },
      "output_guardrails_config": {
        "enabled": true,
        "guardrail_name": "<string>",
        "additional_config": {},
        "block": [
          "policy_violation"
        ]
      }
    },
    "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.enkryptai.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

Response

Registry server created successfully

​
message
string

Response message

​
data
object