Story Protocol SDK MCP
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]
Overview
Story Protocol SDK MCP is a server that provides Model Context Protocol (MCP) tools for interacting with Story's Python SDK, enabling AI agents to manage and utilize various services within the Story Protocol ecosystem.
To use the Story Protocol SDK MCP, clone the repository from GitHub, install the required dependencies, set up environment variables, and run the respective MCP servers for StoryScan and Story SDK.
- Tools for querying blockchain data and managing IP assets. - Integration with IPFS for image uploads and metadata creation. - Support for minting and registering IP assets with license terms.
- Querying blockchain data for address balances and transactions.
- Minting and managing NFTs and IP assets.
- Uploading images and creating metadata for NFTs.
Add to your AI client
Use these steps to connect Story Protocol SDK MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"story-protocol-sdk-mcp-piplabs": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-story-protocol-sdk-mcp-piplabs"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"story-protocol-sdk-mcp-piplabs": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-story-protocol-sdk-mcp-piplabs"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"story-protocol-sdk-mcp-piplabs": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-story-protocol-sdk-mcp-piplabs"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"story-protocol-sdk-mcp-piplabs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-story-protocol-sdk-mcp-piplabs"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"story-protocol-sdk-mcp-piplabs": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-story-protocol-sdk-mcp-piplabs"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"story-protocol-sdk-mcp-piplabs": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-story-protocol-sdk-mcp-piplabs"
]
}
}
}FAQ
What are the prerequisites for using the SDK?
You need Python 3.12+ and the UV package manager installed.
How do I run the servers?
Navigate to the respective server directory and use the command `uv run mcp dev server.py`.
Can I add new MCP servers?
Yes! You can create a new directory for your server and implement the MCP protocol.