ContextForge - Gateway Administration

{% if is_admin and '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 is_admin and 'export-import' not in hidden_sections %} {% endif %} {% if is_admin and 'version-info' not in hidden_sections %} {% endif %} {% if is_admin and 'maintenance' not in hidden_sections %} {% endif %} {% if is_admin and '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 = (pagination.page if pagination is defined else (page if page is defined else 1)) %} {% set per_page = (pagination.per_page if pagination is defined else (per_page if per_page is defined else 50)) %} {% set total_items = (pagination.total_items if pagination is defined else (total_items if total_items is defined else (servers|length if servers is defined else 0))) %} {% set total_pages = (pagination.total_pages if pagination is defined else ((total_items + per_page - 1) // per_page)) %} {% 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 } %} {# 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_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 %}

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...

Tags

Enter tags separated by commas. Tags help categorize and filter servers.

Visibility

🌍Public

👥Team

🔒Private

Enable OAuth 2.0 for MCP Client Authentication

When enabled, MCP clients can authenticate using browser-based OAuth/SSO per RFC 9728.

{% endif %} {% if 'tools' not in hidden_sections %}

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 = (pagination.page if pagination is defined else (page if page is defined else 1)) %} {% set per_page = (pagination.per_page if pagination is defined else (per_page if per_page is defined else 50)) %} {% set total_items = (pagination.total_items if pagination is defined else (total_items if total_items is defined else (tools|length if tools is defined else 0))) %} {% set total_pages = (pagination.total_pages if pagination is defined else ((total_items + per_page - 1) // per_page)) %} {% 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 } %} {# 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_indicator = '#tools-loading' %} {% set table_name = 'tools' %} {% set query_params = {'include_inactive': include_inactive} %} {% include 'pagination_controls.html' %}

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": "MCP-Gateway/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

Tags

Enter tags separated by commas. Tags help categorize and filter tools.

Visibility

🌍Public

👥Team

🔒Private

{% if toolops_enabled %} {% endif %} {% endif %} {% if 'resources' not in hidden_sections %} {% endif %} {% if 'prompts' not in hidden_sections %} {% endif %} {% if 'overview' not in hidden_sections %}

Loading overview...

{% endif %} {% if 'gateways' not in hidden_sections %}

MCP Servers & Federated Gateways (MCP Registry)

Show Inactive

Loading gateways...

{# ---- compute safe pagination values first ---- #} {% set page = (pagination.page if pagination is defined else (page if page is defined else 1)) %} {% set per_page = (pagination.per_page if pagination is defined else (per_page if per_page is defined else 50)) %} {% set total_items = (pagination.total_items if pagination is defined else (total_items if total_items is defined else (gateways|length if gateways is defined else 0))) %} {% set total_pages = (pagination.total_pages if pagination is defined else ((total_items + per_page - 1) // per_page)) %} {% 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 } %} {# 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_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 %}

Add New MCP Server or Gateway

MCP Server Name

MCP Server Name is required.

MCP Server URL

MCP Server URL is required.

Description

Tags

Separate multiple tags with commas. Tags will be automatically normalized (lowercase, spaces→hyphens).

Visibility

🌍Public

👥Team

🔒Private

Transport Type

Authentication Type

Grant Type

Issuer URL

The OAuth Authorization Server issuer URL. Required for DCR (Dynamic Client Registration).

Client ID (optional for DCR)

💡 Leave empty if the server supports DCR - credentials will be auto-registered

Client Secret (optional for DCR)

💡 Leave empty if the server supports DCR - credentials will be auto-registered

Token URL

Authorization URL

The OAuth provider's authorization endpoint URL

Redirect URI

This must match the redirect URI configured in your OAuth application

💡 Use: {{ request.base_url }}oauth/callback

Token Management

Store access tokens for reuse Automatically refresh expired tokens

Token management options for Authorization Code flow

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 %} {% if email_auth_enabled and 'teams' not in hidden_sections %} {% endif %} {% if email_auth_enabled and is_admin 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 %}

A2A Agents Catalog

Manage Agent-to-Agent compatible agents that can be integrated as tools

Show Inactive

Registered A2A Agents

Loading agents...

{# ---- compute safe pagination values first ---- #} {% set page = (pagination.page if pagination is defined else (page if page is defined else 1)) %} {% set per_page = (pagination.per_page if pagination is defined else (per_page if per_page is defined else 50)) %} {% set total_items = (pagination.total_items if pagination is defined else (total_items if total_items is defined else (a2a_agents|length if a2a_agents is defined else 0))) %} {% set total_pages = (pagination.total_pages if pagination is defined else ((total_items + per_page - 1) // per_page)) %} {% 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 } %} {# build the refresh URL for controls #} {% set controls_url = root_path + '/admin/a2a/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/a2a/partial' %} {% set hx_target = '#agents-table' %} {% set hx_indicator = '#agents-loading' %} {% set table_name = 'agents' %} {% set query_params = {'include_inactive': include_inactive} %} {% include 'pagination_controls.html' %}

Registered A2A Agents

{% if a2a_agents %} {% for agent in a2a_agents %} {% endfor %} {% else %} {% endif %}

Actions	ID	Name	Description	Endpoint	Tags	Type	Status	Reachability	Owner	Team	Visibility
{% if agent.enabled %} {% else %} {% endif %}	{{ loop.index }}	{{ agent.name }}	{{ agent.description \| decode_html }}	{{ agent.endpointUrl }}	{% if agent.tags %} {% for tag in agent.tags %} {% if tag is mapping %}{{ tag.id }}{% else %}{{ tag }}{% endif %} {% endfor %} {% endif %}	{{ agent.agentType }}	{% if agent.enabled %}Active{% else %}Inactive{% endif %}	{% if agent.reachable %}Reachable{% else %}Unreachable{% endif %}	{{ agent.ownerEmail }}	{{ agent.team }}	{% if agent.visibility == 'private' %} Private {% elif agent.visibility == 'team' %} Team {% elif agent.visibility == 'public' %} Public {% else %} N/A {% endif %}
No A2A agents registered yet.

Add New A2A Agent

Agent Name

Agent Name is required.

Endpoint URL

Endpoint URL is required.

Agent Type

Authentication Type

Grant Type

Issuer URL

The OAuth Authorization Server issuer URL. Required for DCR (Dynamic Client Registration).

Client ID (optional for DCR)

💡 Leave empty if the server supports DCR - credentials will be auto-registered

Client Secret (optional for DCR)

💡 Leave empty if the server supports DCR - credentials will be auto-registered

Token URL

Authorization URL

The OAuth provider's authorization endpoint URL

Redirect URI

This must match the redirect URI configured in your OAuth application

💡 Use: {{ request.base_url }}oauth/callback

Token Management

Store access tokens for reuse Automatically refresh expired tokens

Token management options for Authorization Code flow

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 Agent 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")

Description

Tags

Visibility

🌍 Public

👥 Team

🔒 Private

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

{% endif %} {% if grpc_enabled and 'agents' 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 %}

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

Add New Root

{% endif %} {% if is_admin and '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

Registered A2A Agents

Add New A2A Agent

Authorization Code Flow Setup

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

Server Details

Edit Server

Agent Details

Test A2A Agent

Export Configuration for

Client Configuration

Root Details

Edit Root

Bulk Import Tools

Import Instructions

📋 JSON Validation Rules