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 to your AI assistant. You'll sign in once and then the assistant can access your game data. The same URL works for every client:

https://mcp.savecraft.gg

Claude.ai

  1. Open claude.ai and sign in.
  2. Click your profile icon in the lower left, then click Settings.
  3. Click Connectors in the sidebar.
  4. Click Add Custom Connector.
  5. Paste this URL and click Save: https://mcp.savecraft.gg
  6. Claude will ask you to authorize Savecraft. Click Allow. You'll sign in to Savecraft if you aren't already.
  7. Go back to a chat and ask something like: “What games do I have in Savecraft?”
  8. Success looks like: Claude responds with your game saves — character names, levels, builds, and stats.

ChatGPT

  1. Open chatgpt.com and sign in.
  2. Click your name in the lower left, then click Settings.
  3. Click Apps, expand the Advanced settings bar, then click Create App.
  4. Fill in the form:
    • Name: Savecraft
    • MCP URL: https://mcp.savecraft.gg
    • Authentication: OAuth
    • Check “I understand and want to continue”, then click Create.
  5. ChatGPT will ask you to authorize Savecraft. Click Allow. You'll sign in to Savecraft if you aren't already.
  6. Start a new chat and ask something like: “What games do I have in Savecraft?”
  7. Success looks like: ChatGPT responds with your game saves — character names, levels, builds, and stats.

You can revoke access at any time from your sources page. Your AI assistant never sees your password — only a token that grants access to your saves and notes.

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).
setup_helpReturns 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