Specter MCP Server

Configure a Specter game backend from chat: economy, progression, leaderboards, multiplayer.

Local serverstdio

What is the Specter MCP server?

Configure a Specter game backend from chat: economy, progression, leaderboards, multiplayer. Exposed over MCP by the specter mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

specter-skills teaches Claude everything about Specter — the game backend platform — so you can add player accounts, an in-game economy, daily quests, leaderboards, tournaments, battle passes, and real-time multiplayer to your game in plain English, and get correct, working code plus the ability to configure your backend without ever opening the dashboard.

Adding it to your client

The server ships on npm as specter-skills, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Its toolset

Everything the assistant can do here goes through one of these:

  • specter_verify_setup — Smoke-test the project: auth, currencies, events, tasks
  • specter_list_events — List custom events (with their ids) that trigger tasks
  • specter_get_player_state — Read the test player's tasks, wallet, and inventory
  • specter_send_event — Fire a custom event (the same call your game makes) to trigger achievements
  • specter_test_achievement — End-to-end: read status → fire the event → re-read → report whether the task progressed
  • specter_generate_client_code — Generate ready-to-paste game code (JS or Unity C#) wired with your real api-key + event slug
  • specter_create_event — A custom event that triggers achievements
  • specter_create_match — Multiplayer match template (format / outcome / game)
  • specter_schedule_liveops — Schedule a leaderboard / competition live
  • specter_grant_reward — Grant items / currencies to a player
  • specter_login — Browser sign-in (above)
  • Setup — The Setup tool exposed by this server

Configuration

You will need 5 environment variables: SPECTER_ENV, SPECTER_ALLOW_MUTATIONS, SPECTER_PROJECT_ID, SPECTER_API_KEY, SPECTER_ADMIN_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js 18+ - A Specter project + API key (console.specterapp.xyz) - A skills-aware Claude host (Claude Code, Claude Desktop, or the Agent SDK) for the skills; an MCP-compatible host for the server ---

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Specter.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the specter mcp server does with a few real requests.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Specter's toolset — specter_verify_setup, specter_list_events, specter_get_player_state and 11 more — is a fair guide to whether it matches your workflow. It is maintained by dirtcubeinteractive; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
specter_verify_setupSmoke-test the project: auth, currencies, events, tasks
specter_list_eventsList custom events (with their ids) that trigger tasks
specter_get_player_stateRead the test player's tasks, wallet, and inventory
specter_send_eventFire a custom event (the same call your game makes) to trigger achievements
specter_test_achievementEnd-to-end: read status → fire the event → re-read → report whether the task progressed
specter_generate_client_codeGenerate ready-to-paste game code (JS or Unity C#) wired with your real api-key + event slug
specter_create_eventA custom event that triggers achievements
specter_create_matchMultiplayer match template (format / outcome / game)
specter_schedule_liveopsSchedule a leaderboard / competition live
specter_grant_rewardGrant items / currencies to a player
specter_loginBrowser sign-in (above)
SetupThe Setup tool exposed by this server.
ToolsThe achievement tools resolve friendly names for you — pass event as an event slug/name, rewards as [{currency:"gems", quantity:50}] (or item/bundle/marker), and the tool resolves them to the right ids. Creating an achie
ConfigurationThe Configuration tool exposed by this server.

How to install the Specter MCP server

{
  "mcpServers": {
    "specter-skills": {
      "command": "npx",
      "args": ["-y", "specter-skills"],
      "env": {
        "SPECTER_ENV": "your-value",
        "SPECTER_ALLOW_MUTATIONS": "your-value",
        "SPECTER_PROJECT_ID": "your-value",
        "SPECTER_API_KEY": "your-value",
        "SPECTER_ADMIN_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js 18+ - A Specter project + API key (console.specterapp.xyz) - A skills-aware Claude host (Claude Code, Claude Desktop, or the Agent SDK) for the skills; an MCP-compatible host for the server ---
VariableDescriptionRequired
SPECTER_ENVConfiguration value read at startup.Optional
SPECTER_ALLOW_MUTATIONSConfiguration value read at startup.Optional
SPECTER_PROJECT_IDConfiguration value read at startup.Optional
SPECTER_API_KEYCredential the server authenticates with.Yes
SPECTER_ADMIN_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Specter to specter verify setup.
  • Use Specter to specter list events.
  • Use Specter to specter get player state.

Frequently asked questions

It connects Specter to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (specter_verify_setup, specter_list_events, specter_get_player_state, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Specter directly.