Story SDK MCP Server

An MCP server for the Story SDK and Storyscan Block Explorer

Local serverstdioPython

What is the Story SDK MCP server?

If you already use Story SDK, the story sdk mcp server is the piece that lets your assistant work with it directly. An MCP server for the Story SDK and Storyscan Block Explorer.

What the server does

This repository serves as a central hub for Story Protocol's Model Context Protocol (MCP) servers. It provides a unified environment for running and managing various MCP services that enable AI agents to interact with Story Protocol's ecosystem.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Prerequisites — The Prerequisites tool exposed by this server
  • Installation — The Installation tool exposed by this server
  • Cursor — Cursor implements an MCP client that supports an arbitrary number of MCP servers with both stdio and sse transports
  • Troubleshooting — 1. Verify that environment variables are set correctly for each server 2. Check network connectivity to external APIs (StoryScan, IPFS, etc.) 3

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Credentials and setup notes

  • Python 3.12+ - UV package manager

Where it fits

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Story SDK's toolset — Prerequisites, Installation, Cursor and 1 more — is a fair guide to whether it matches your workflow. It is maintained by piplabs; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Worth knowing first

  • 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.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
InstallationThe Installation tool exposed by this server.
CursorCursor implements an MCP client that supports an arbitrary number of MCP servers with both stdio and sse transports.
Troubleshooting1. Verify that environment variables are set correctly for each server 2. Check network connectivity to external APIs (StoryScan, IPFS, etc.) 3. Ensure you're using the correct Python version (3.12+) 4. Check that all de

How to install the Story SDK MCP server

{
  "mcpServers": {
    "storyscan-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/path/to/story-mcp-hub/storyscan-mcp",
        "run",
        "server.py"
      ]
    },
    "story-sdk-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/path/to/story-mcp-hub/story-sdk-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.12+ - UV package manager

Example prompts to try

  • Use Story SDK to Prerequisites.
  • Use Story SDK to Installation.
  • Use Story SDK to Cursor.

Frequently asked questions

Python 3.12+, the UV package manager, and project dependencies installed via `uv sync`.