Story SDK MCP Server
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Provides tools to interact with IPFS storage, including uploading images and creating metadata
Story MCP Hub
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.
Project Structure
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 addressget_transactions
: Get recent transactions for an addressget_stats
: Get current blockchain statisticsget_address_overview
: Get a comprehensive overview of an addressget_token_holdings
: Get all ERC-20 token holdings for an addressget_nft_holdings
: Get all NFT holdings for an addressinterpret_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 IDmint_license_tokens
: Mint license tokens for a specific IP and license termssend_ip
: Send IP tokens to a specified address using native token transferupload_image_to_ipfs
: Upload an image to IPFS and return the URIcreate_ip_metadata
: Create NFT metadata for a specific image URImint_and_register_ip_with_terms
: Mint and register an IP with terms
Setup
Prerequisites
- Python 3.12+
- UV package manager
Installation
- Install UV package manager and install env:
- Clone this repository:
- Install dependencies using UV:
- Set up environment variables for each server:
For StoryScan MCP:
For Story SDK MCP:
Running the Servers
StoryScan MCP Server Inspector
Story SDK MCP Server
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 arbitrary number of MCP servers with both stdio
and sse
transports.
Adding MCP Servers in Cursor
- Go to
Cursor Settings
>Features
>MCP
- Click on the
+ Add New MCP Server
button - Fill out the form:
- Select the transport under
Type
- Enter a nickname for the server in the
Name
field - Enter either the command to run or the URL of the server, depending on the transport
- We'll use the
uv
command to run the server, so make sure to include the--directory
flag with the path to the server (Example:uv --directory ~/path/to/story-mcp-hub/storyscan-mcp run server.py
)
- Select the transport under
Project-Specific MCP Configuration
You can configure project-specific MCP servers using .cursor/mcp.json
. The file follows this format:
Using MCP Tools in Cursor
The Composer Agent will automatically use any MCP tools that are listed under Available Tools
on the MCP settings page if it determines them to be relevant. To prompt tool usage intentionally, simply tell the agent to use the tool, referring to it either by name or by description.
When the Agent wants to use an MCP tool, it will display a message asking for your approval.
Claude Desktop
Claude Desktop can be configured to use MCP servers by editing its configuration file.
Adding MCP Servers in Claude Desktop
- Open the Claude Desktop configuration file:
- Add the MCP server configuration:
- Save the file and restart Claude Desktop for the changes to take effect.
Example query: use storyscan to check balance of 0x95A13F457C76d10A40D7e8497eD4F40c53F4d04b
Development
To add a new MCP server to the hub:
- Create a new directory for your server
- Implement the MCP protocol in your server
- Add any necessary dependencies to the root
pyproject.toml
- Update this README with information about your server
Troubleshooting
If you encounter issues:
- Verify that environment variables are set correctly for each server
- Check network connectivity to external APIs (StoryScan, IPFS, etc.)
- Ensure you're using the correct Python version (3.12+)
- Check that all dependencies are installed with
uv sync
License
This server cannot be installed
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.
- Project Structure
- MCP Servers
- Setup
- Running the Servers
- Using with MCP Clients
- Development
- Troubleshooting
- License