Story SDK MCP Server

This server provides MCP (Model Context Protocol) tools for interacting with Story's Python SDK.

Features

• Get license terms
• Mint and register IP Asset with PIL Terms
• Mint license tokens
• Send $IP to a wallet
• Upload image to ipfs via Pinata [External]
• Upload ip and nft metadata via Pinata [External]

Setup

1. Install dependencies using uv:

2. Copy .env.example to .env and fill in your credentials:

Environment variables:

• WALLET_PRIVATE_KEY: Your EVM wallet private key
• RPC_PROVIDER_URL: Your RPC provider URL. You can use the default one provided.
• SPG_NFT_CONTRACT: The address of the SPG NFT contract. You can use the default one provided.
• PINATA_JWT: [optional] JWT for uploading images/metadata to pinata. You need this to upload metadata to IPFS when registering an IP. You can get this by creating a new app on pinata

3. Use inspector to test the server:

Available Tools

1. get_license_terms: Retrieve license terms for a specific ID
2. mint_license_tokens: Mint license tokens for a specific IP and license terms
3. send_ip: Send IP tokens to a specified address using native token transfer
4. upload_image_to_ipfs: Upload an image to IPFS and return the URI
5. create_ip_metadata: Create NFT metadata for a specific image URI
6. mint_and_register_ip_with_terms: Mint and register an IP with terms

Example mint_and_register_ip_with_terms

You can use the following parameters to test the tool:

1. commercial_rev_share: 5
2. derivatives_allowed: True
3. registration_metadata:

Usage with MCP

You can use these tools with any MCP-compatible client. The tools are exposed through the MCP protocol and can be accessed using any AI framework of your choosing.