crewai-nory 0.1.0

CrewAI tools for x402 payments - let crews pay for APIs autonomously

crewai-nory

CrewAI tools for x402 payments - Let your agent crews pay for APIs autonomously.

Overview

crewai-nory provides CrewAI tools that enable your agent crews to:

• Pay for x402-protected APIs automatically when they encounter HTTP 402 responses
• Access pre-built paid APIs for crypto prices, weather, translation, and more
• Make direct payments to any Solana or EVM wallet

All payments use USDC stablecoin on Solana (~400ms settlement).

Installation

pip install crewai-nory

Quick Start

from crewai import Agent, Task, Crew
from crewai_nory import get_nory_tools

# Get all Nory tools (uses NORY_WALLET_KEY env var)
tools = get_nory_tools()

# Create an agent with payment capabilities
researcher = Agent(
    role="Market Researcher",
    goal="Get real-time cryptocurrency market data",
    backstory="You are an expert market analyst with access to premium data sources.",
    tools=tools,
    verbose=True
)

# Create a task
task = Task(
    description="Get the current prices of Bitcoin, Ethereum, and Solana. Analyze the 24h changes.",
    expected_output="A summary of current prices and market trends",
    agent=researcher
)

# Run the crew
crew = Crew(agents=[researcher], tasks=[task])
result = crew.kickoff()
print(result)

Available Tools

Tool	Description	Cost per request
NoryPaymentTool	Fetch any URL with automatic x402 payment	Varies
NoryCryptoPricesTool	Real-time crypto prices (BTC, ETH, SOL, etc.)	$0.001
NoryWeatherTool	Weather + 7-day forecast for any city	$0.002
NoryTranslateTool	Translate between 20+ languages	$0.005
NoryQRCodeTool	Generate QR codes	$0.001
NoryWebSummaryTool	Extract text from any webpage	$0.01

Environment Variables

export NORY_WALLET_KEY="your-solana-private-key"

Individual Tool Usage

from crewai_nory import NoryCryptoPricesTool

# Use individually
crypto_tool = NoryCryptoPricesTool(wallet_key="your-key")
prices = crypto_tool.run("BTC,ETH,SOL")

Multi-Agent Example

from crewai import Agent, Task, Crew, Process
from crewai_nory import get_nory_tools

tools = get_nory_tools()

# Research agent with payment capabilities
researcher = Agent(
    role="Market Researcher",
    goal="Gather real-time market data",
    tools=tools
)

# Analyst agent (no tools needed, analyzes data from researcher)
analyst = Agent(
    role="Market Analyst",
    goal="Analyze market data and provide insights"
)

# Writer agent
writer = Agent(
    role="Report Writer",
    goal="Write clear, actionable market reports"
)

# Sequential tasks
research_task = Task(
    description="Get current prices for top 10 cryptocurrencies",
    agent=researcher
)

analysis_task = Task(
    description="Analyze the market data and identify trends",
    agent=analyst
)

report_task = Task(
    description="Write a concise market report",
    agent=writer
)

crew = Crew(
    agents=[researcher, analyst, writer],
    tasks=[research_task, analysis_task, report_task],
    process=Process.sequential
)

result = crew.kickoff()

How It Works

1. Your agent requests a paid API endpoint
2. Server returns 402 Payment Required with payment requirements
3. NoryPaymentTool creates and signs a USDC transfer on Solana
4. Payment settles in ~400ms
5. Agent retries request with payment proof
6. Server verifies and returns data

All of this happens automatically - agents just use the tools normally.

Links

• Website: noryx402.com
• Documentation: noryx402.com/docs
• x402 Protocol: github.com/coinbase/x402
• npm packages: nory-x402-payer | nory-mcp-server

License

MIT