Story MCP Hub

@piplabs

About Story MCP Hub

An MCP server for the Story SDK and Storyscan Block Explorer

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "story-mcp-hub": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Story MCP Hub?

Story MCP Hub is a central repository for Story Protocol’s Model Context Protocol (MCP) servers. It provides a unified environment for running and managing MCP services that enable AI agents to interact with Story Protocol’s ecosystem—querying blockchain data via StoryScan and executing SDK‑based operations like IP registration, licensing, and royalty management.

How to use Story MCP Hub?

Install prerequisites (Python 3.12+ and UV), clone the repo, run uv sync, then set up environment variables per server. Start each server with uv run mcp dev server.py inside its directory. Configure MCP clients like Cursor or Claude Desktop by adding the server’s uv command in the client’s settings or a .cursor/mcp.json file.

Key features of Story MCP Hub

Two bundled MCP servers: StoryScan and Story SDK
Query blockchain data: transactions, address overview, token/NFT holdings
Register and manage IP assets with license terms
Mint license tokens and predict minting fees
Upload images and metadata to IPFS via Pinata
Manage revenue: pay royalties, claim all revenue
Raise disputes and manage WIP tokens

Use cases of Story MCP Hub

AI agents retrieving on‑chain analytics and address histories
Automated IP registration and license token minting for NFTs
Programmatic royalty payment and revenue claiming
Uploading NFT metadata to IPFS and creating SPG collections
Debugging transactions via human‑readable interpretation

FAQ from Story MCP Hub

What are the prerequisites for using Story MCP Hub?

Python 3.12+ and the UV package manager are required. Install UV with curl -LsSf https://astral.sh/uv/install.sh | sh.

How do I install and run the servers?

Clone the repository, run uv sync to install dependencies, then set up .env files for each server. Start a server with uv run mcp dev server.py inside its directory.

How can I connect Story MCP Hub to Cursor?

In Cursor Settings > Features > MCP, add a new server with uv --directory ~/path/to/storyscan-mcp run server.py (adjust path for Story SDK). Alternatively, use a .cursor/mcp.json file.

How do I configure story MCP Hub in Claude Desktop?

Edit ~/Library/Application Support/Claude/claude_desktop_config.json and add the same uv command as an MCP server entry, then restart Claude Desktop.

Is there any external service required for IPFS tools?

Yes, the upload_image_to_ipfs and create_ip_metadata tools require a Pinata JWT (set as PINATA_JWT environment variable).

Frequently asked questions

What are the prerequisites for using Story MCP Hub?

Python 3.12+ and the UV package manager are required. Install UV with `curl -LsSf https://astral.sh/uv/install.sh | sh`.

How do I install and run the servers?

Clone the repository, run `uv sync` to install dependencies, then set up `.env` files for each server. Start a server with `uv run mcp dev server.py` inside its directory.

How can I connect Story MCP Hub to Cursor?

In Cursor Settings > Features > MCP, add a new server with `uv --directory ~/path/to/storyscan-mcp run server.py` (adjust path for Story SDK). Alternatively, use a `.cursor/mcp.json` file.

How do I configure story MCP Hub in Claude Desktop?

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` and add the same `uv` command as an MCP server entry, then restart Claude Desktop.

Is there any external service required for IPFS tools?

Yes, the `upload_image_to_ipfs` and `create_ip_metadata` tools require a Pinata JWT (set as `PINATA_JWT` environment variable).

Comments

Basic information

More Other MCP servers

Website

FunnyWolf

Adversary simulation and Red teaming platform with AI

5.1K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K