specter_verify_setupLABSCO SUMMARY
Create tools stay off unless your setup turns them on.
Most of this surface writes to live game configuration — currencies, quests and leaderboards that players are already touching — so those tools load only when SPECTER_ALLOW_MUTATIONS is true, and your client asks you to confirm each one before it runs. The test-player tools are the unusual part: specter_test_achievement fires the same event your game fires, then re-reads the state, so you find out whether a quest rule works instead of assuming it does.
What it is
One npm package with two halves: a set of skills that teach Claude the Specter game-backend API — players, economy, progression, competitions, multiplayer — and an MCP server, specter-mcp, that lets it act on a project. The skills make the integration code correct; the server inspects and configures the backend so you are not clicking through the dashboard.
What you get
specter_verify_setupsmoke-tests a project across auth, currencies, events and tasksspecter_list_currencies,specter_list_events,specter_list_tasksandspecter_list_progression_systemsread back what already existsspecter_create_currency,specter_create_task,specter_create_mission,specter_create_leaderboardandspecter_create_battlepassbuild economy, progression and competition contentspecter_send_eventandspecter_test_achievementfire a real client event as a sandboxed test player and report whether the task actually progressedspecter_generate_client_codeemits ready-to-paste JavaScript or Unity C# wired to your api-key and event slugspecter_admin_callandspecter_client_callreach any endpoint that has no dedicated tool
Requirements
- Node.js 18+ and a Specter project.
- Runs over stdio as
npx -y -p specter-skills specter-mcp(packagespecter-skills, version 0.11.1). - The Claude Desktop config in Installation leaves
SPECTER_ALLOW_MUTATIONSatfalse; Specter's setup helper,npx specter-skills mcp(or--codefor Claude Code), sets it totrue. SPECTER_ENVin your config picks staging or production, and defaults to staging.- Read tools need a one-time browser sign-in for that same environment. Run
npx -y -p specter-skills specter-mcp loginin a terminal for staging, orSPECTER_ENV=production npx -y -p specter-skills specter-mcp loginfor production. It saves a revocable token to~/.specter/credentials.json— no api-key to paste. With create tools on, Claude can start the sign-in for you throughspecter_login.
Setup effort
One command — npx -y -p specter-skills specter-mcp
USE CASES
Checking a Specter project is wired up correctly
Run one smoke test over auth, currencies, events and tasks instead of clicking through the dashboard.
Setting up a daily quest and proving it fires
Create the event and the task, then fire the event as a test player and read the progress back.
Building out an economy from a description
Ask for a currency and the exchange rates between currencies, and get them created in the project.
Getting integration code that matches your real config
Generate JavaScript or Unity C# already wired to your api-key and event slug.
26 tools
Listed in project docs. Your client may show a different list.
specter_list_currenciesspecter_list_eventsspecter_list_tasksspecter_list_progression_systemsspecter_get_player_statespecter_send_eventspecter_test_achievementspecter_get_reward_historyspecter_claim_rewardspecter_generate_client_codespecter_create_currencyspecter_create_currency_conversionspecter_create_eventspecter_create_taskspecter_create_missionspecter_schedule_achievementspecter_create_battlepassspecter_create_matchspecter_create_leaderboardspecter_edit_currencyspecter_schedule_liveopsspecter_grant_rewardspecter_admin_callspecter_client_callspecter_loginBEFORE YOU INSTALL
What to know first
Tools you get
26 tools named in the project's documentation.
Requires
npx on PATH; Node.js 18+
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
npx -y -p specter-skills specter-mcpMCP Clients
Claude Desktop
{
"mcpServers": {
"specter": {
"command": "npx",
"args": [
"-y",
"-p",
"specter-skills",
"specter-mcp"
],
"env": {
"SPECTER_ENV": "staging",
"SPECTER_ALLOW_MUTATIONS": "false"
}
}
}
}