Langgraph MCP Agent

🚀 Story IP Creator Agent

This is an agent based on LangGraph, designed to create, mint, and register IP assets on Story.

🔍 Overview

This agent assists users in generating AI images, uploading them to IPFS, and registering them as IP assets on the Story blockchain. The process includes:

1. Generate images using DALL - E 3.
2. Obtain user approval for the generated images.
3. Upload the approved images to IPFS.
4. Create IP metadata.
5. Negotiate license terms with the user.
6. Mint and register the IP on Story.
7. Mint the license token for the IP.

📋 Requirements

• Python 3.9+
• LangGraph
• LangChain
• OpenAI API key (for DALL - E and GPT models)
• Story SDK

📁 Directory Structure

This agent requires a specific directory structure to function properly:

your-root-directory/
├── langgraph-mcp-agent/
│   ├── agent.py
│   └── ...
├── story-mcp-hub/          
│   ├── story-sdk-mcp/
│   │   ├── server.py
│   │   └── ...
│   └── ...

📦 Installation

1. Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone this repository and navigate to the project directory.
3. Install dependencies using uv:

uv sync

4. Set up environment variables:

cp .env.example .env

Then edit the .env file, replacing all variables with your API keys and configurations. 5. Clone the story-sdk-mcp repository into the same folder where you cloned this repository, as shown in the Directory Structure section above. Set up and install the MCP server according to the README instructions, ensuring that all .env variables are set. You don't need to run it; just place it in the same folder so that this agent can access it.

💻 Usage

Run the agent:

uv run agent.py

The agent will guide you through an interactive process to:

1. Enter an image description (e.g., "Anime - style character skiing").
2. Review the generated images and approve them or request new ones.
3. Set license terms, including:
   • Percentage of commercial revenue sharing (0 - 100%).
   • Whether to allow derivative works (Yes/No).
4. Complete the minting process on the Story blockchain.

💻 Usage Examples

🔍 Basic Usage

When you run agent.py, you'll experience a workflow like this:

=== Story IP Creator ===
This tool will help you create and mint an image as an IP asset in the Story ecosystem.

What kind of image do you want to create? (e.g., "Anime - style character skiing"): blob skateboarding on the mountaintop

Starting the creation process...

[Generate an image and provide a link]

Do you like this image? (Yes/No + feedback): Yes
Uploading the image to IPFS...

[Generate metadata]

Enter the commercial revenue share (0 - 100%, default: 15%): 20
Allow derivative works? (Yes/No, default: Yes): Yes

[Minting and registration process]

=== Process completed ===
Your IP has been successfully created and registered on Story!

This agent handles all the complex interactions with DALL - E for image generation, IPFS for storage, and the Story blockchain for minting and registration.