ContextForge - Gateway Administration

{% if 'logs' not in hidden_sections %}

📋 System Logs

Level

Component

Search / Correlation ID

Loading logs...

Time	Level	Component	Message	User	Duration	Correlation ID

0 logs

{% endif %} {% if 'export-import' not in hidden_sections %} {% endif %} {% if 'version-info' not in hidden_sections %} {% endif %} {% if 'maintenance' not in hidden_sections %} {% endif %} {% if 'plugins' not in hidden_sections %} {% endif %} {% if performance_enabled and is_admin %} {% endif %} {% if observability_enabled and is_admin %} {% endif %} {% if llmchat_enabled %} {% endif %} {% if 'settings' not in hidden_sections %} {% endif %} {% if 'mcp-registry' not in hidden_sections %} {% endif %} {% if 'servers' not in hidden_sections %}

{% if not catalog_enabled %}

Catalog is currently disabled

Set MCPGATEWAY_CATALOG_ENABLED=true to enable catalog-backed server operations.

{% endif %}

Virtual MCP Servers

Virtual Servers let you combine Tools, Resources, and Prompts into an MCP Server with its own API key (see API Tokens).

Show Inactive

Loading servers...

{# ---- compute safe pagination values first ---- #} {% set page = page if page is defined else 1 %} {% set per_page = per_page if per_page is defined else 50 %} {% set total_items = servers|length if servers is defined else 0 %} {% set total_pages = (total_items + per_page - 1) // per_page if total_items > 0 else 0 %} {% set has_prev = page > 1 %} {% set has_next = (page * per_page) < total_items %} {% set pagination = { 'page': page, 'per_page': per_page, 'total_items': total_items, 'total_pages': total_pages, 'has_prev': has_prev, 'has_next': has_next, 'page_items': None } %} {# build the refresh URL for controls #} {% set controls_url = root_path + '/admin/servers/partial' + '?render=controls' + '&page=' + page|string + '&per_page=' + per_page|string + '&include_inactive=' + (include_inactive|default(false)|string|lower) %}

{# helpers used by pagination_controls.html #} {% set base_url = root_path + '/admin/servers/partial' %} {% set hx_target = '#servers-table' %} {% set hx_swap = 'outerHTML' %} {% set hx_indicator = '#servers-loading' %} {% set table_name = 'servers' %} {% set query_params = {'include_inactive': include_inactive} %} {% include 'pagination_controls.html' %}

{% for server in servers %} {% endfor %}

Icon	S. No.	UUID	Name	Description	Tools	Resources	Prompts	Tags	Owner	Team	Visibility	Actions
{% if server.icon %} {% else %} N/A {% endif %}	{{ loop.index }}	{{ server.id }}	{{ server.name }}	{{ server.description \| decode_html }}	{% if server.associatedTools %} {{ server.associatedTools \| length }} tool{{ 's' if server.associatedTools \| length != 1 else '' }} {% else %} 0 tools {% endif %}	{% if server.associatedResources %} {{ server.associatedResources \| length }} resource{{ 's' if server.associatedResources \| length != 1 else '' }} {% else %} 0 resources {% endif %}	{% if server.associatedPrompts %} {{ server.associatedPrompts \| length }} prompt{{ 's' if server.associatedPrompts \| length != 1 else '' }} {% else %} 0 prompts {% endif %}	{% if server.tags %} {% for tag in server.tags %} {% if tag is mapping %} {{ tag.id }} {% else %} {{ tag }} {% endif %} {% endfor %} {% else %} None {% endif %}	{% if server.ownerEmail %} {{ server.ownerEmail }} {% else %} N/A {% endif %}	{% if server.team %} {{ server.team }} {% else %} N/A {% endif %}	{% if server.visibility == 'private' %} Private {% elif server.visibility == 'team' %} Team {% elif server.visibility == 'public' %} Public {% else %} N/A {% endif %}	{% if server.enabled %} {% else %} {% endif %}

{% if user_permissions.can_create_server %}

Add New Server

Custom UUID (optional)

Provide a custom UUID if you need to preserve an existing server ID

Name

Name is required.

Description

Icon URL

MCP Servers

Loading MCP servers...

Choose an MCP server, then select the tools, resources, and prompts to configure your virtual server.

Associated Tools

Loading tools...

Associated Resources

Loading resources...

Associated Prompts

Loading prompts...

MCP Tools

This is the global catalog of MCP Tools available. You can also add custom tools from REST APIs. Create a Virtual Server using one of these tools.

Annotation badges: 📖 Read-Only ⚠️ Destructive 🔄 Idempotent 🌐 External Access

Show Inactive

Loading tools...

{# ---- compute safe pagination values first ---- #} {% set page = page if page is defined else 1 %} {% set per_page = per_page if per_page is defined else 50 %} {% set total_items = tools|length if tools is defined else 0 %} {% set total_pages = (total_items + per_page - 1) // per_page if total_items > 0 else 0 %} {% set has_prev = page > 1 %} {% set has_next = (page * per_page) < total_items %} {% set pagination = { 'page': page, 'per_page': per_page, 'total_items': total_items, 'total_pages': total_pages, 'has_prev': has_prev, 'has_next': has_next, 'page_items': None } %} {# build the refresh URL for controls #} {% set controls_url = root_path + '/admin/tools/partial' + '?render=controls' + '&page=' + page|string + '&per_page=' + per_page|string + '&include_inactive=' + (include_inactive|default(false)|string|lower) %}

{# helpers used by pagination_controls.html #} {% set base_url = root_path + '/admin/tools/partial' %} {% set hx_target = '#tools-table' %} {% set hx_swap = 'outerHTML' %} {% set hx_indicator = '#tools-loading' %} {% set table_name = 'tools' %} {% set query_params = {'include_inactive': include_inactive} %} {% include 'pagination_controls.html' %}

{% if user_permissions.can_create_tool %}

Add New Tool from REST API

Convert existing REST API to an MCP Tool

📥 Bulk Import Information

Import multiple tools from a JSON array. The system automatically fixes common formatting issues like tool name spaces and tag formats.

Maximum: 200 tools per import

Sample JSON Template:

[
  {
    "name": "weather-api",
    "displayName": "Weather API Tool",
    "url": "https://api.openweathermap.org/data/2.5/weather",
    "integration_type": "REST",
    "request_type": "GET",
    "description": "Get current weather data for any location",
    "auth_type": "bearer",
    "auth_value": "your-openweather-api-key-here",
    "headers": {
      "Accept": "application/json",
      "User-Agent": "ContextForge/1.0"
    },
    "input_schema": {
      "type": "object",
      "properties": {
        "q": {"type": "string", "description": "City name"},
        "units": {"type": "string", "description": "Temperature units"}
      },
      "required": ["q"]
    },
    "jsonpath_filter": "$.main",
    "tags": ["weather", "api", "external"]
  }
]

Auth Types: basic, bearer, authheaders, oauth, or none

Required Fields: name, url, integration_type, request_type

Optional Fields: displayName, description, auth_type, auth_value, headers, input_schema, jsonpath_filter, tags

Choose Import Method:

Upload File Paste JSON

Name

Name is required.

Display Name (optional)

URL

URL is required.

Description

Integration Type

Request Type

Headers (JSON)

Input Schema (JSON)

Schema Builder JSON Input

Output Schema (JSON)

Optional JSON Schema for validating structured tool output. Leave empty if not needed.

Json Path Filter

Authentication Type

MCP Servers & Federated Gateways (MCP Registry)

Show Inactive

Loading gateways...

{# ---- compute safe pagination values first ---- #} {% set page = page if page is defined else 1 %} {% set per_page = per_page if per_page is defined else 50 %} {% set total_items = gateways|length if gateways is defined else 0 %} {% set total_pages = (total_items + per_page - 1) // per_page if total_items > 0 else 0 %} {% set has_prev = page > 1 %} {% set has_next = (page * per_page) < total_items %} {% set pagination = { 'page': page, 'per_page': per_page, 'total_items': total_items, 'total_pages': total_pages, 'has_prev': has_prev, 'has_next': has_next, 'page_items': None } %} {# build the refresh URL for controls #} {% set controls_url = root_path + '/admin/gateways/partial' + '?render=controls' + '&page=' + page|string + '&per_page=' + per_page|string + '&include_inactive=' + (include_inactive|default(false)|string|lower) %}

{# helpers used by pagination_controls.html #} {% set base_url = root_path + '/admin/gateways/partial' %} {% set hx_target = '#gateways-table' %} {% set hx_swap = 'outerHTML' %} {% set hx_indicator = '#gateways-loading' %} {% set table_name = 'gateways' %} {% set query_params = {'include_inactive': include_inactive} %} {% include 'pagination_controls.html' %}

{% for gateway in gateways %} {% endfor %}

S. No.	Name	URL	Tags	Status	Last Seen	Owner	Team	Visibility	Actions
{{ loop.index }}	{{ gateway.name }}	{{ gateway.url }}	{% if gateway.tags %} {% for tag in gateway.tags %} {% if tag is mapping %}{{ tag.id }}{% else %}{{ tag }}{% endif %} {% endfor %} {% else %} No tags {% endif %}	{% set enabled = gateway.enabled %} {% set reachable = gateway.reachable %} {% if enabled and reachable %} {% set bg_class = "bg-green-100 text-green-800" %} {% elif enabled and not reachable %} {% set bg_class = "bg-yellow-100 text-yellow-800" %} {% else %} {% set bg_class = "bg-red-100 text-red-800" %} {% endif %} {% if enabled %} {% if reachable %} Active {% else %} Offline {% endif %} {% else %} Inactive {% endif %} {% if not enabled %} 💡Gateway is Manually Deactivated {% elif not reachable %} 💡Gateway is Not Reachable {% else %} 💡Everything stable. {% endif %}	{{ gateway.lastSeen.strftime('%Y-%m-%d %H:%M:%S') if gateway.lastSeen else 'Never' }}	{{ gateway.ownerEmail }}	{% if gateway.team %} {{ gateway.team }} {% else %} N/A {% endif %}	{% if gateway.visibility == 'private' %} Private {% elif gateway.visibility == 'team' %} Team {% elif gateway.visibility == 'public' %} Public {% else %} N/A {% endif %}	{% if gateway.authType == 'oauth' %} 🔐 Authorize {% else %} {% endif %} {% if gateway.enabled %} {% else %} {% endif %}

{% if user_permissions.can_create_gateway %}

Add New MCP Server or Gateway

MCP Server Name

MCP Server Name is required.

MCP Server URL

MCP Server URL is required.

Description

Authorization Code Flow Setup

After creating this gateway, you'll need to:

Click the "🔐 Authorize" button in the gateway list
Complete the OAuth consent flow with your provider
Return to the admin panel to see authorization status

Note: The gateway will be created but tools won't work until OAuth authorization is completed.

Scopes

Space-separated list of OAuth scopes (e.g., "repo read:user")

Use one-time authentication

Passthrough Headers List of headers to pass through from client requests (comma-separated, e.g., "Authorization, X-Tenant-Id, X-Trace-Id"). Leave empty to use global defaults.

Upload CA certificate

Click to upload or drag and drop

Public certificate files only (.pem, .crt, .cer, .cert)

{% endif %}

{% endif %} {% if email_auth_enabled and 'teams' not in hidden_sections %} {% endif %} {% if email_auth_enabled and 'users' not in hidden_sections %} {% endif %} {% if email_auth_enabled and 'tokens' not in hidden_sections %} {% endif %} {% if a2a_enabled and 'agents' not in hidden_sections %} {% endif %} {% if grpc_enabled and 'grpc-services' not in hidden_sections %} {% endif %} {% if 'roots' not in hidden_sections %}

Root Directories

Roots define the base folders accessible for file-based Resources. They enable MCP servers to browse local content.

{% for root in roots %} {% endfor %}

Actions	ID	URI	Name
	{{ loop.index }}	{{ root.uri }}	{{ root.name }}

Add New Root

{% endif %} {% if 'metrics' not in hidden_sections %} {% endif %} {% if is_admin %} {% endif %}

📋 System Logs

Configuration Export & Import

📤 Export Configuration

📥 Import Configuration

📊 Import Status

📋 Recent Import Operations

Virtual Servers

Available Tools

Start a Conversation

API Key Required

Virtual MCP Servers

Add New Server

MCP Tools

Add New Tool from REST API

📥 Bulk Import Information

Choose Import Method:

Import Preview

📊 Import Results

Tool Operations

Selected Tools

Operations

Tool Details

MCP Resources

Add New Resource

MCP Prompts

Add New Prompt

MCP Servers & Federated Gateways (MCP Registry)

Add New MCP Server or Gateway

Authorization Code Flow Setup

👥 My Teams

User Management

Create New User

System Users

API Token Management

Create New API Token

⚠️ Token Scope

Token Scoping (Optional)

Your API Tokens

A2A Agents Catalog

Registered A2A Agents

Add New A2A Agent

Authorization Code Flow Setup

Universal Agent ID (UAID) Settings

gRPC Services Registry

Register New gRPC Service

Registered gRPC Services

{{ service.name }}

Root Directories

Add New Root

System Metrics

Top Performers

Tool Details

Generate Test Cases

Generate Test Cases

View Descriptions

Test Tool

Test Tool

Edit Tool

Resource Details

Result

Edit Resource

Prompt Details

Edit Prompt

Test Prompt

Rendered Prompt

Gateway Details

Test Gateway Connectivity

Edit Gateway

Edit A2A Agent

Universal Agent ID (UAID) Settings

Server Details

Edit Server

Agent Details

Test A2A Agent

Export Configuration for

Client Configuration

Root Details

Edit Root

Bulk Import Tools

Import Instructions