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 toolsPublic 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
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MCP_API_KEYsecretAPI key for authenticated tool calls. Issue one on /admin → API Keys. Required when AUTH_MODE=write or AUTH_MODE=all.
AUTH_MODEAuthentication mode: off (default), write (write+pii tools gated), all (every tool gated).
MCP_USERSsecretExtra username/password users: 'alice:secret:read,write'. Comma-separated, colon-delimited.
RATE_LIMITMax tool calls per window per caller. Default 60.
Readme
Details
- Repository
- github.com/markusvankempen/mcp-reference-server
- Package
mcp-reference-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active