Story SDK MCP Server

@piplabs

Repository

Basic information

About Story SDK MCP Server

An MCP server for the Story SDK and Storyscan Block Explorer

#story-protocol#mcp #sdk

Story SDK MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "story-sdk-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Story SDK MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Story SDK MCP Server?

Story SDK MCP Server provides tools that enable AI agents to interact with Story Protocol’s Python SDK. It handles IP asset registration, license management, royalty payments, NFT collection creation, and token operations through the Model Context Protocol.

How to use Story SDK MCP Server?

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.

Key features of Story SDK MCP Server

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

Use cases of Story SDK MCP Server

Register an NFT as an Intellectual Property asset on Story Protocol
Automate license token minting and royalty payment workflows
Create and manage SPG NFT collections for IP asset registration
Raise disputes against IP assets and claim revenue from child IPs

Frequently asked questions

What dependencies does Story SDK MCP Server require?

Python 3.12+, the UV package manager, and project dependencies installed via `uv sync`.

What environment variables are needed?

A wallet private key and RPC provider URL are required. For IPFS tools, a PINATA_JWT must also be set.

How does Story SDK MCP Server communicate with clients?

It uses the stdio transport of the Model Context Protocol (MCP). Clients such as Cursor and Claude Desktop invoke the server as a subprocess via a `uv` command.

What blockchain and storage does it interact with?

It makes RPC calls to the Story Protocol blockchain and API calls to IPFS (via Pinata) for metadata and image storage.

Are there known limitations?

IPFS tools require a valid Pinata JWT. The server uses a single wallet private key for all blockchain transactions; test tokens can be minted if the contract has a public mint/faucet function.

Comments

More Developer Tools MCP servers

Jaybird Digital

Steve Wheeler

Jaybird Digital lets you build a website for you in the conversation. Tell your ai about your business and what you want, and it writes the pages and saves them to Jaybird. You get a link to view the site right away, wi

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci

Crawl Readiness

Grubbomatic

AI SEO tools for MCP clients — audit whether AI crawlers can read a website, validate JSON-LD and robots.txt, and generate llms.txt, AI-crawler-aware robots.txt, and JSON-LD schema without leaving the conversation.

PubShip

pubship

Open-source MCP server for Google Play developer workflows. Runs locally with your own credentials.