Story SDK MCP Server
About
An MCP server for the Story SDK and Storyscan Block Explorer
Details
- Author
- piplabs
- GitHub stars
- 17
- Downloads
- 366
- Categories
- Developer Tools
Jump to
- IPFS & Metadata: upload images, create and upload IP metadata (requires PINATA_JWT)
- License Management: get terms, mint license tokens, predict fees
- IP Asset Management: register NFTs, attach license terms, mint and register with terms
- NFT Collection Tools: create SPG NFT collections, get minting fee
- Revenue & Royalty: pay royalties, claim all revenue from child IPs
- Dispute & Token Tools: raise disputes, deposit/transfer WIP, check ERC20 balances, mint test ERC20 tokens
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Story SDK MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install dependencies with uv sync, configure environment variables (wallet private key, RPC provider URL, optional PINATA_JWT for IPFS), then run uv run mcp dev server.py in the story-sdk-mcp directory. Connect to MCP clients like Cursor or Claude Desktop by adding the server as a stdio command using uv --directory <path> run server.py.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"story sdk mcp server": {
"story-sdk-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"story-sdk-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}Story SDK MCP Server
Provides tools for interacting with Story Protocol's Python SDK.
Tools:
IPFS & Metadata Tools (requires PINATA_JWT):
- upload_image_to_ipfs: Upload an image to IPFS using Pinata API and return the URI
- create_ip_metadata: Create and upload both NFT and IP metadata to IPFS
License Management Tools:
- get_license_terms: Retrieve license terms for a specific ID
- get_license_minting_fee: Get the minting fee for a specific license terms ID
- get_license_revenue_share: Get the commercial revenue share percentage for a specific license terms ID
- mint_license_tokens: Mint license tokens for a given IP and license terms (auto-approves WIP tokens)
- predict_minting_license_fee: Pre-compute the minting license fee for given IP, license terms and amount
IP Asset Management Tools:
- register: Register an NFT as IP, creating a corresponding IP record
- attach_license_terms: Attach license terms to an IP asset
- mint_and_register_ip_with_terms: Mint and register an IP with terms
NFT Collection Tools:
- create_spg_nft_collection: Create a new SPG NFT collection that can be used for minting and registering IP assets
- get_spg_nft_minting_token: Get the minting fee required by an SPG NFT contract
Revenue & Royalty Tools:
- pay_royalty_on_behalf: Pay royalties to a receiver IP asset on behalf of a payer IP asset (auto-approves tokens)
- claim_all_revenue: Claim all revenue from child IPs of an ancestor IP with optional auto-transfer
Dispute Tools:
- raise_dispute: Raise a dispute against an IP asset (auto-approves WIP bond tokens)
Token Management Tools:
- deposit_wip: Wrap IP to WIP and deposit to wallet
- transfer_wip: Transfer WIP tokens to a recipient
- get_erc20_token_balance: Get the balance of any ERC20 token for an account
- mint_test_erc20_tokens: Mint test ERC20 tokens if the contract has a public mint/faucet function
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
