How do I use MetaMCP Admin MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MetaMCP Admin MCP list all my MetaMCP instances" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MetaMCP Admin MCP

by danielrosehill

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

MetaMCP Admin MCP

An MCP server for administering MetaMCP instances — manage servers, namespaces, endpoints, and API keys across multiple MetaMCP deployments from any MCP client.

This is not the MetaMCP proxy (which aggregates tools). This is an admin tool that lets AI agents manage MetaMCP itself: add/remove servers, create namespaces, toggle tools, compare instances, and more.

Features

Multi-instance: Manage multiple MetaMCP deployments from a single MCP server
Full CRUD: Create, read, update, delete servers, namespaces, endpoints, and API keys
Bulk import: Import servers in Claude Desktop JSON format
Cross-instance ops: Compare servers across instances, clone server configs between instances
Health checks: Verify connectivity to all instances
Tool management: Inspect tools per server, toggle tools/servers within namespaces

Available Tools (22)

Tool	Description
`list_instances`	List all configured MetaMCP instances
`health_check`	Check connectivity to all instances
`compare_instances`	Compare servers/namespaces/endpoints across instances
`list_servers`	List all MCP servers on an instance
`get_server`	Get server details by UUID
`create_server`	Create a new MCP server
`update_server`	Update an existing server
`delete_server`	Delete a server
`bulk_import_servers`	Import servers from Claude Desktop JSON format
`clone_server`	Copy a server config from one instance to another
`list_namespaces`	List all namespaces
`get_namespace`	Get namespace details with servers
`create_namespace`	Create a new namespace
`update_namespace`	Update a namespace
`delete_namespace`	Delete a namespace
`get_namespace_tools`	List tools in a namespace
`toggle_server_in_namespace`	Enable/disable a server in a namespace
`toggle_tool_in_namespace`	Enable/disable a specific tool in a namespace
`list_endpoints`	List all endpoints
`get_endpoint`	Get endpoint details
`create_endpoint`	Create a new endpoint
`delete_endpoint`	Delete an endpoint
`list_api_keys`	List all API keys
`create_api_key`	Create a new API key
`delete_api_key`	Delete an API key
`get_server_tools`	List tools for a specific server

Installation

npm install -g metamcp-admin-mcp

Or clone and build:

git clone https://github.com/danielrosehill/metamcp-admin-mcp.git
cd metamcp-admin-mcp
npm install
npm run build

Configuration

Single instance

export METAMCP_BASE_URL="http://localhost:12008"
export METAMCP_INSTANCE_NAME="desktop"          # optional
export METAMCP_SESSION_COOKIE="better-auth.session_token=..."  # from browser

Multiple instances

export METAMCP_INSTANCES='[
  {
    "name": "desktop",
    "baseUrl": "http://localhost:12008",
    "sessionCookie": "better-auth.session_token=..."
  },
  {
    "name": "vm",
    "baseUrl": "https://mcp.example.com",
    "sessionCookie": "better-auth.session_token=..."
  }
]'

MetaMCP uses Better Auth for session management. To get your session cookie:

Open MetaMCP in your browser
Open DevTools (F12) → Application → Cookies
Copy the better-auth.session_token value
Use it as sessionCookie in config (prefix with better-auth.session_token=)

Claude Desktop / Claude Code config

{
  "mcpServers": {
    "metamcp-admin": {
      "command": "node",
      "args": ["/path/to/metamcp-admin-mcp/dist/index.js"],
      "env": {
        "METAMCP_INSTANCES": "[{\"name\":\"desktop\",\"baseUrl\":\"http://localhost:12008\",\"sessionCookie\":\"better-auth.session_token=...\"}]"
      }
    }
  }
}

How it works

MetaMCP exposes a tRPC API for its admin frontend. This MCP server acts as a tRPC client, calling those same endpoints with session cookie authentication. This means you get the same capabilities as the MetaMCP web UI, but accessible from any MCP client.

API Coverage

Built against the MetaMCP tRPC API:

frontend.mcpServers.* — Full CRUD + bulk import
frontend.namespaces.* — Full CRUD + tool/server status management
frontend.endpoints.* — Full CRUD
frontend.apiKeys.* — Create, list, delete
frontend.tools.* — Query by server

License

MIT

Available Tools

26 tools

bulk_import_serversB

Bulk import MCP servers (Claude Desktop JSON format)

Inputs: servers (required), instance.

clone_serverC

Copy an MCP server config from one instance to another

Inputs: serverUuid (required), sourceInstance (required), targetInstance (required).

compare_instancesB

Compare MCP servers across all configured MetaMCP instances

Inputs: no named parameters.

create_api_keyC

Create a new API key

Inputs: name (required), instance.

create_endpointC

Create a new endpoint exposing a namespace

Inputs: name (required), namespaceUuid (required), description, enableApiKeyAuth, +2 more.

create_namespaceC

Create a new namespace

Inputs: name (required), description, mcpServerUuids, instance.

create_serverC

Create a new MCP server on a MetaMCP instance

Inputs: name (required), type (required), description, command, +6 more.

delete_api_keyC

Delete an API key