Context Forge - Gateway Administration

AI Gateway and Registry supporting MCP, A2A and REST | Docs | ⭐ GitHub |

{% if email_auth_enabled %}

{% endif %}

🖥️ MCP Servers 🔗 Virtual Servers 🛠️ Tools 💬 Prompts 📁 Resources {% if a2a_enabled %} 🤖 Agents (A2A) {% endif %} {% if grpc_enabled %} 🔌 gRPC Services {% endif %} 📊 Metrics 🔌 Plugins 📦 MCP Registry {% if llmchat_enabled %} 👨‍💻 LLM Chat {% endif %} {% if email_auth_enabled %} 👥 Teams {% endif %}

System Logs

Level

Entity Type

Loading stats...

Time	Level	Entity	Message

0 logs

{% if llmchat_enabled %} {% 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).

Available tags:

{% 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 }}	{% 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 %} {{ tag }} {% endfor %} {% else %} None {% endif %}	{% if server.ownerEmail %} {{ server.ownerEmail }} {% else %} N/A {% endif %}	{% if server.team %} {{ server.team.replace(' ', ' ')\|safe }} {% 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.isActive %} {% else %} {% endif %}

Add New Server

Custom UUID (optional)

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

Name

Description

Icon URL

Associated Tools

{% for tool in tools %} {{ tool.displayName or tool.customName or tool.name }} {% endfor %}

Associated Resources

{% for resource in resources %}

{% endfor %}

Associated Prompts

{% for prompt in prompts %}

{% endfor %}

Tags

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

Visibility

🌍Public

👥Team

🔒Private

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

Filter by Tags:

Available tags:

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

Display Name (optional)

URL

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

MCP Resources

Resources are reusable data assets from MCP servers-like text, code, or media. You can also add custom resources that Tools and Prompts can reference by URI.

Show Inactive

Filter by Tags:

Available tags:

{% for resource in resources %} {% endfor %}

ID	URI	Name	Description	MIME Type	Tags	Owner	Team	Visibility	Status	Actions
{{ resource.id }}	{{ resource.uri }}	{{ resource.name }}	{{ resource.description or "N/A" }}	{{ resource.mimeType or "N/A" }}	{% if resource.tags %} {% for tag in resource.tags %} {{ tag }} {% endfor %} {% else %} None {% endif %}	{% if resource.ownerEmail %} {{ resource.ownerEmail }} {% else %} N/A {% endif %}	{% if resource.team %} {{ resource.team.replace(' ', ' ')\|safe }} {% else %} N/A {% endif %}	{% if resource.visibility == 'private' %} Private {% elif resource.visibility == 'team' %} Team {% elif resource.visibility == 'public' %} Public {% else %} N/A {% endif %}	{{ "Active" if resource.isActive else "Inactive" }}	{% if resource.isActive %} {% else %} {% endif %}

Add New Resource

URI

Name

Description

MIME Type

Content

Tags

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

Visibility

🌍Public

👥Team

🔒Private

MCP Prompts

Prompts define reusable message templates with parameters from MCP servers. You can also add custom prompts, useful for driving LLM interactions or Tool input.

Show Inactive

Filter by Tags:

Available tags:

{% for prompt in prompts %} {% endfor %}

ID	Name	Description	Arguments	Tags	Owner	Team	Visibility	Status	Actions
{{ prompt.id }}	{{ prompt.name }}	{{ prompt.description }}	{% for arg in prompt.arguments %}{{ arg.name }}{% if not loop.last %}, {% endif %}{% endfor %}	{% if prompt.tags %} {% for tag in prompt.tags %} {{ tag }} {% endfor %} {% else %} None {% endif %}	{% if prompt.ownerEmail %} {{ prompt.ownerEmail }} {% else %} N/A {% endif %}	{% if prompt.team %} {{ prompt.team.replace(' ', ' ')\|safe }} {% else %} N/A {% endif %}	{% if prompt.visibility == 'private' %} Private {% elif prompt.visibility == 'team' %} Team {% elif prompt.visibility == 'public' %} Public {% else %} N/A {% endif %}	{{ "Active" if prompt.isActive else "Inactive" }}	{% if prompt.isActive %} {% else %} {% endif %}

Add New Prompt

Name

Description

Template

Arguments (JSON)

Tags

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

Visibility

🌍Public

👥Team

🔒Private

MCP Servers & Federated Gateways (MCP Registry)

Show Inactive

Filter by Tags:

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

S. No.	Name	URL	Tags	Status	Last Seen	Team	Visibility	Actions
{{ loop.index }}	{{ gateway.name }}	{{ gateway.url }}	{% if gateway.tags %} {% for tag in gateway.tags %} {{ tag }} {% 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' }}	{% if gateway.team %} {{ gateway.team.replace(' ', ' ')\|safe }} {% 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 URL

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

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.

{% if email_auth_enabled %} {% endif %} {% if email_auth_enabled %} {% endif %} {% if email_auth_enabled %} {% endif %} {% if a2a_enabled %} {% endif %} {% if grpc_enabled %} {% endif %}

Root Directories

Show Inactive

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

System Logs

Configuration Export & Import

📤 Export Configuration

📥 Import Configuration

📊 Import Status

📋 Recent Import Operations

Virtual Servers

Environment Variables

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

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

⚠️ Public Access Token

Token Scoping (Optional)

Your API Tokens

A2A Agents Catalog

Add New A2A Agent

Registered A2A Agents

{{ agent.name }}

gRPC Services Registry

Register New gRPC Service

Registered gRPC Services

{{ service.name }}

Root Directories

Add New Root

System Metrics

Aggregated Metrics

Tool Details

Test Tool

Edit Tool

Resource Details

Edit Resource

Prompt Details

Edit Prompt

Test Prompt

Rendered Prompt

Gateway Details

Test Gateway Connectivity

Edit Gateway

Server Details

Edit Server

Agent Details

Export Configuration for

Client Configuration

Bulk Import Tools

Import Instructions

📋 JSON Validation Rules

Choose Import Method:

Import Preview

Create New Team

Team Join Requests

Invite User to Team

Assign Role to User