Documentation

Connect your AI assistant to your actual game state — characters, gear, progress, and goals — parsed from real save files and game APIs.

What is Savecraft?

Savecraft is an MCP server that gives AI assistants access to your video game data. It works two ways: a local daemon watches your save files on your PC and pushes parsed game state to the cloud, and server-side adapters pull character data from game APIs like Battle.net. Both feed the same set of MCP tools, so your AI assistant sees your real characters, gear, stats, and progress — not hallucinated guesses.

Your assistant can read your game state, search across saves and notes, run reference computations (like exact drop rates or stat breakpoints), and help you track goals between sessions using notes.

Connect your assistant

Add Savecraft as an MCP server in your AI client. You'll sign in once via Clerk (our auth provider) and then the assistant can access your game data.

Claude.ai

Go to Settings → Integrations → Add MCP Server. Enter the URL:

https://mcp.savecraft.gg/sse

You'll be redirected to Clerk to sign in, then back to Claude.

ChatGPT

Once Savecraft is listed in the App Directory, enable it from Settings → Connected Apps. Until then, use the MCP developer preview with this URL:

https://mcp.savecraft.gg/mcp

Claude Code

Run this command in your terminal:

claude mcp add savecraft \
  --transport sse \
  https://mcp.savecraft.gg/sse

Cursor / VS Code

Add to your .cursor/mcp.json or VS Code MCP settings:

{
  "servers": {
    "savecraft": {
      "type": "sse",
      "url": "https://mcp.savecraft.gg/sse"
    }
  }
}

Authentication

Savecraft delegates all authentication to Clerk. When you connect an AI assistant, you'll be redirected to a Clerk-hosted sign-in page. After authenticating, you're sent back to Savecraft and the assistant receives a scoped OAuth token. The assistant never sees your password or credentials — only a token that grants access to your saves and notes.

You can revoke access at any time from your sources page.

What you can do

Here are examples of things you can ask your AI assistant once Savecraft is connected.

Game state

  • “What level is my character and what difficulty am I on?”
  • “Show me what gear my character has equipped.”
  • “What skills do I have allocated?”
  • “Compare my resistances — am I ready for the next difficulty?”

Notes & planning

  • “Save a note with my farming goals for this week.”
  • “What notes do I have on my Paladin?”
  • “Update my build guide — I swapped to a different weapon.”

Reference data

  • “What are the exact drop rates for this item with my magic find?”
  • “Calculate the stat breakpoints I need to hit.”

Search

  • “Search my saves for anything related to swords.”
  • “Do any of my notes mention farming routes?”

What Savecraft doesn't do

Savecraft provides your game data — it doesn't replace the AI's general knowledge. Questions like “What's the best build for a Paladin?” or “How do I beat this boss?” use the AI's own training data, not Savecraft. Savecraft kicks in when the answer depends on your actual game state.

Tools reference

Savecraft exposes 11 MCP tools. Your AI assistant chooses the right tool automatically based on your question — you don't need to call these directly.

ToolWhat it does
list_gamesReturns all your games, saves, note titles, and available reference modules.
get_saveGets a save's summary, overview, available sections, and attached notes.
get_sectionFetches detailed section data from a save (gear, skills, stats, etc.).
get_noteFetches the full content of a note.
create_noteCreates a note attached to a save.
update_noteUpdates a note's title or content.
delete_notePermanently deletes a note.
refresh_saveRequests fresh data from your source or game API.
search_savesFull-text search across all saves and notes.
query_referenceRuns a reference computation (drop rates, stat calculations, breakpoints).
get_savecraft_infoReturns setup help, privacy info, or project details.

How your data gets here

Local daemon

A lightweight service on your PC watches your game's save directory. When a save file changes, the daemon parses it with a game-specific WASM plugin and pushes structured game state to Savecraft over WebSocket. Supports any game with local save files.

API adapters

For games with public APIs (like Battle.net), Savecraft fetches your character data server-side. No daemon needed — just link your game account and your data stays current automatically.

Game mods

For moddable games, a Savecraft mod can push game state directly from inside the game. No daemon, no save file parsing — the mod sees everything the game knows.

More