markusvankempen avatar

Mcp Reference Server

markusvankempen/mcp-reference-server

Reference MCP server to check, validate and test clients and SEPs. 22 tools, stdio and HTTP.

tools
22
auth
Secret needed
transport
STDIO
env vars
4
last updated
Nov 13, 2026

Tools

22 tools

Public tool metadata for what this MCP can expose to an agent.

describe_serverFirst call, and after any denial

First call, and after any denial

No parameter schema in public metadata yet.

create_ticketOpen a ticket — always pass requester_email

Open a ticket — always pass requester_email

No parameter schema in public metadata yet.

add_commentComment on a known ticket

Comment on a known ticket

No parameter schema in public metadata yet.

close_ticketResolve a ticket, optionally add resolution note

Resolve a ticket, optionally add resolution note

No parameter schema in public metadata yet.

get_schemaBefore any query

Before any query

No parameter schema in public metadata yet.

run_queryThe one query tool: schema=tickets, schema=customers, plus assets, timers, system, settings, events (and, for an admin, users, api_keys, trace, errors, counters)

The one query tool: schema=tickets, schema=customers, plus assets, timers, system, settings, events (and, for an admin, users, api_keys, trace, errors, counters)

No parameter schema in public metadata yet.

update_settingsEvery setting is one patch: auth mode, rate limit, call trace, desk sign-in, SEPs, transports, events, gates, locks and scopes

Every setting is one patch: auth mode, rate limit, call trace, desk sign-in, SEPs, transports, events, gates, locks and scopes

No parameter schema in public metadata yet.

set_mqtt

No parameter schema in public metadata yet.

create_user

No parameter schema in public metadata yet.

delete_user

No parameter schema in public metadata yet.

issue_api_key

No parameter schema in public metadata yet.

revoke_api_key

No parameter schema in public metadata yet.

import_settings

No parameter schema in public metadata yet.

generate_trafficSample traffic

Sample traffic

No parameter schema in public metadata yet.

start_timer

No parameter schema in public metadata yet.

stop_timer

No parameter schema in public metadata yet.

push_timerStreams the timer as events

Streams the timer as events

No parameter schema in public metadata yet.

push_logSends a log line as an event

Sends a log line as an event

No parameter schema in public metadata yet.

watch_systemPublishes the machine as system.info, including a container's cgroup limit

Publishes the machine as system.info, including a container's cgroup limit

No parameter schema in public metadata yet.

run_test_jobWaits a set time and ends as a chosen task status, to test long-running calls and SEP-2663 tasks

Waits a set time and ends as a chosen task status, to test long-running calls and SEP-2663 tasks

No parameter schema in public metadata yet.

draft_replyAsks the connected client's model for a draft and does not post it

Asks the connected client's model for a draft and does not post it

No parameter schema in public metadata yet.

list_workspace_rootsReturns the workspace roots the client chose to share and does not read the files

Returns the workspace roots the client chose to share and does not read the files

No parameter schema in public metadata yet.

Sponsors

Configuration

MCP_API_KEYsecret

API key for authenticated tool calls. Issue one on /admin → API Keys. Required when AUTH_MODE=write or AUTH_MODE=all.

AUTH_MODE

Authentication mode: off (default), write (write+pii tools gated), all (every tool gated).

MCP_USERSsecret

Extra username/password users: 'alice:secret:read,write'. Comma-separated, colon-delimited.

RATE_LIMIT

Max tool calls per window per caller. Default 60.

Readme

MCP Reference Server — A Full-Stack MCP Demo

npm MCP Protocol SEPs Tools Node.js License


View the full README on GitHub

Details

Repository
github.com/markusvankempen/mcp-reference-server
Package
mcp-reference-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from markusvankempen