Story SDK
Provides tools for managing IP assets and licenses, interacting with the Story Python SDK, and handling operations like minting tokens, registering IP, and uploading metadata to IPFS.
What is Story SDK?
Story SDK is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides tools for managing ip assets and licenses, interacting with the story python sdk, and handling operations like minting tokens, registering ip, and uploading metadata to ipfs.
Provides tools for managing IP assets and licenses, interacting with the Story Python SDK, and handling operations like minting tokens, registering IP, and uploading metadata to IPFS.
This server falls under the APIs and File Systems categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides tools for managing IP assets and licenses, interact
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx story-sdk-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Story SDK
Story SDK MCP Server is part of the Story MCP Hub — a collection of MCP servers for Story Protocol, the on-chain intellectual property platform. The story-sdk-mcp server gives AI agents the ability to upload images to IPFS, create and attach IP metadata, register NFTs as IP assets, manage license terms, mint license tokens, pay and claim royalties, raise disputes, and handle WIP token transfers — all by calling Story Protocol's Python SDK through standardized MCP tool calls. A companion server, storyscan-mcp, adds read-only blockchain data queries including transactions, address overviews, and NFT holdings.
Prerequisites
- Python 3.12 or later
- uv package manager (curl -LsSf https://astral.sh/uv/install.sh | sh)
- A Story Protocol-compatible wallet private key
- An RPC provider URL for the Story Protocol blockchain
- A Pinata JWT for IPFS uploads (required for image and metadata tools)
Install uv package manager
The project uses uv for dependency management. Install it if you don't have it.
curl -LsSf https://astral.sh/uv/install.sh | shClone the Story MCP Hub
Clone the piplabs/story-mcp-hub repository which contains both the story-sdk-mcp and storyscan-mcp servers.
git clone https://github.com/piplabs/story-mcp-hub.git
cd story-mcp-hubInstall dependencies
Use uv to sync and install all Python dependencies declared in pyproject.toml.
uv syncConfigure environment variables for story-sdk-mcp
Copy the example env file and fill in your wallet private key, RPC URL, and Pinata JWT for IPFS uploads.
cd story-sdk-mcp
cp .env.example .env
# Edit .env:
# WALLET_PRIVATE_KEY=0x...
# RPC_PROVIDER_URL=https://...
# PINATA_JWT=eyJ...Add the server to Claude Desktop config
Register the story-sdk-mcp server with your MCP client. Use uv run to launch it inside the managed environment.
{
"mcpServers": {
"story-sdk-mcp": {
"command": "uv",
"args": ["run", "mcp", "run", "server.py"],
"cwd": "/path/to/story-mcp-hub/story-sdk-mcp",
"env": {
"WALLET_PRIVATE_KEY": "0x...",
"RPC_PROVIDER_URL": "https://...",
"PINATA_JWT": "eyJ..."
}
}
}
}Story SDK Examples
Client configuration
Claude Desktop configuration for the Story SDK MCP server with wallet, RPC, and IPFS credentials.
{
"mcpServers": {
"story-sdk-mcp": {
"command": "uv",
"args": ["run", "mcp", "run", "server.py"],
"cwd": "/Users/yourname/story-mcp-hub/story-sdk-mcp",
"env": {
"WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
"RPC_PROVIDER_URL": "https://your-rpc-provider.example.com",
"PINATA_JWT": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
}
}
}Prompts to try
Example tasks you can ask Claude to perform once the Story SDK MCP server is connected.
- "Upload this image to IPFS and return the URI"
- "Register my NFT with token ID 42 from contract 0x123... as an IP asset on Story Protocol"
- "Get the license terms for license ID 1 and show me the revenue share percentage"
- "Mint 5 license tokens for IP asset 0xabc... using license terms ID 1"
- "Pay royalties of 10 WIP to IP asset 0xdef... on behalf of my IP asset 0xabc..."
- "Create a new SPG NFT collection called 'My IP Collection'"Troubleshooting Story SDK
IPFS upload fails with 'PINATA_JWT not set' or authentication error
Set the PINATA_JWT environment variable in your .env file or directly in the MCP client config env block. You can get a JWT from app.pinata.cloud under API Keys.
Transaction fails with 'insufficient WIP balance' when minting license tokens
Use the deposit_wip tool first to wrap native IP tokens into WIP. License minting and royalty payment tools auto-approve WIP spending, but you must have a sufficient WIP balance in your wallet.
uv run fails with 'command not found' or dependency errors
Make sure uv is installed and on your PATH (run 'which uv'). Run 'uv sync' from the story-mcp-hub root to install all project dependencies before starting the server.
Frequently Asked Questions about Story SDK
What is Story SDK?
Story SDK is a Model Context Protocol (MCP) server that provides tools for managing ip assets and licenses, interacting with the story python sdk, and handling operations like minting tokens, registering ip, and uploading metadata to ipfs. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Story SDK?
Follow the installation instructions on the Story SDK GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Story SDK?
Story SDK works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Story SDK free to use?
Yes, Story SDK is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Story SDK Alternatives — Similar APIs Servers
Looking for alternatives to Story SDK? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Story SDK in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Story SDK?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.