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