Balance & Stats
check_balance,
get_address_overview,
get_transactions,
interpret_transaction,
get_token_holdings,
get_nft_holdings,
get_stats"] style StoryscanToolset fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8 end end subgraph "Story SDK MCP Server" style Story SDK MCP Server fill:#F5FFFA,stroke:#98FB98,stroke-width:2px,rx:10,ry:10 StoryService["Story Service"] style StoryService fill:#E6E6FA,stroke:#9370DB,stroke-width:2px,rx:8,ry:8 subgraph "Story SDK Tools" style Story SDK Tools fill:#F0FFF0,stroke:#90EE90,stroke-width:2px,rx:10,ry:10 IPFSTools["IPFS Tools
upload_image_to_ipfs
create_ip_metadata"] style IPFSTools fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8 IPTools["IP Management Tools
mint_and_register_ip_with_terms
get_license_terms,
mint_license_tokens,
send_ip,
create_spg_nft_collection"] style IPTools fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8 end end subgraph "External Resources" style External Resources fill:#FFF0F5,stroke:#FFB6C1,stroke-width:2px,rx:10,ry:10 IPFS[(IPFS/Pinata
Storage)] style IPFS fill:#FFE4E1,stroke:#DB7093,stroke-width:2px,rx:15,ry:15 Blockchain[(Story Protocol
Blockchain)] style Blockchain fill:#E0F8E0,stroke:#90EE90,stroke-width:2px,rx:15,ry:15 StoryScan[(StoryScan/Blockscout
API)] style StoryScan fill:#E6F3FF,stroke:#87CEFA,stroke-width:2px,rx:15,ry:15 end Agent <--MCP Protocol--> StoryService Agent <--MCP Protocol--> StoryscanService StoryscanService --> StoryscanToolset StoryService --> IPFSTools StoryService --> IPTools StoryscanToolset <--API Calls--> StoryScan IPFSTools <--API Calls--> IPFS IPTools <--RPC Calls--> Blockchain ``` ## MCP Servers ### StoryScan MCP Server Provides tools for querying blockchain data, including address balances, transactions, and blockchain statistics. **Tools:** - `check_balance`: Check the balance of an address - `get_transactions`: Get recent transactions for an address - `get_stats`: Get current blockchain statistics - `get_address_overview`: Get a comprehensive overview of an address - `get_token_holdings`: Get all ERC-20 token holdings for an address - `get_nft_holdings`: Get all NFT holdings for an address - `interpret_transaction`: Get a human-readable interpretation of a transaction ### Story SDK MCP Server Provides tools for interacting with Story Protocol's Python SDK. **Tools:** - `get_license_terms`: Retrieve license terms for a specific ID - `mint_license_tokens`: Mint license tokens for a specific IP and license terms - `send_ip`: Send IP tokens to a specified address using native token transfer - `upload_image_to_ipfs`: Upload an image to IPFS and return the URI - `create_ip_metadata`: Create NFT metadata for a specific image URI - `mint_and_register_ip_with_terms`: Mint and register an IP with terms ## Setup ### Prerequisites - Python 3.12+ - UV package manager ### Installation 1. Install UV package manager and install env: ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` 2. Clone this repository: ```bash git clone https://github.com/piplabs/story-mcp-hub.git cd story-mcp-hub ``` 3. Install dependencies using UV: ```bash uv sync ``` 4. Set up environment variables for each server: For StoryScan MCP: ```bash cd storyscan-mcp cp .env.example .env # Edit .env with your StoryScan API endpoint ``` For Story SDK MCP: ```bash cd story-sdk-mcp cp .env.example .env # Edit .env with your wallet private key, RPC provider URL, etc. ``` ## Running the Servers ### StoryScan MCP Server Inspector ```bash cd storyscan-mcp uv run mcp dev server.py ``` ### Story SDK MCP Server ```bash cd story-sdk-mcp uv run mcp dev server.py ``` ## Using with MCP Clients Follow the instructions below to connect the MCP servers to various MCP-compatible clients. ### Cursor Cursor implements an MCP client that supports an

Story Protocol SDK MCP

Comments