Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions lib/crewai-tools/src/crewai_tools/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -100,6 +100,13 @@
from crewai_tools.tools.multion_tool.multion_tool import MultiOnTool
from crewai_tools.tools.mysql_search_tool.mysql_search_tool import MySQLSearchTool
from crewai_tools.tools.nl2sql.nl2sql_tool import NL2SQLTool
from crewai_tools.tools.nory_x402_tool.nory_x402_tool import (
NoryHealthCheckTool,
NoryPaymentRequirementsTool,
NorySettlePaymentTool,
NoryTransactionLookupTool,
NoryVerifyPaymentTool,
)
from crewai_tools.tools.ocr_tool.ocr_tool import OCRTool
from crewai_tools.tools.oxylabs_amazon_product_scraper_tool.oxylabs_amazon_product_scraper_tool import (
OxylabsAmazonProductScraperTool,
Expand Down Expand Up @@ -244,6 +251,11 @@
"MultiOnTool",
"MySQLSearchTool",
"NL2SQLTool",
"NoryHealthCheckTool",
"NoryPaymentRequirementsTool",
"NorySettlePaymentTool",
"NoryTransactionLookupTool",
"NoryVerifyPaymentTool",
"OCRTool",
"OxylabsAmazonProductScraperTool",
"OxylabsAmazonSearchScraperTool",
Expand Down
12 changes: 12 additions & 0 deletions lib/crewai-tools/src/crewai_tools/tools/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,13 @@
from crewai_tools.tools.multion_tool.multion_tool import MultiOnTool
from crewai_tools.tools.mysql_search_tool.mysql_search_tool import MySQLSearchTool
from crewai_tools.tools.nl2sql.nl2sql_tool import NL2SQLTool
from crewai_tools.tools.nory_x402_tool.nory_x402_tool import (
NoryHealthCheckTool,
NoryPaymentRequirementsTool,
NorySettlePaymentTool,
NoryTransactionLookupTool,
NoryVerifyPaymentTool,
)
from crewai_tools.tools.ocr_tool.ocr_tool import OCRTool
from crewai_tools.tools.oxylabs_amazon_product_scraper_tool.oxylabs_amazon_product_scraper_tool import (
OxylabsAmazonProductScraperTool,
Expand Down Expand Up @@ -228,6 +235,11 @@
"MultiOnTool",
"MySQLSearchTool",
"NL2SQLTool",
"NoryHealthCheckTool",
"NoryPaymentRequirementsTool",
"NorySettlePaymentTool",
"NoryTransactionLookupTool",
"NoryVerifyPaymentTool",
"OCRTool",
"OxylabsAmazonProductScraperTool",
"OxylabsAmazonSearchScraperTool",
Expand Down
82 changes: 82 additions & 0 deletions lib/crewai-tools/src/crewai_tools/tools/nory_x402_tool/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
# Nory x402 Payment Tools

Enable CrewAI agents to make payments using the x402 HTTP protocol.

## Description

These tools allow AI agents to handle HTTP 402 "Payment Required" responses programmatically. When an agent encounters a paywall, it can:

1. Get payment requirements (amount, networks, wallet address)
2. Verify a signed transaction
3. Settle the payment on-chain (~400ms)
4. Retry the original request

## Installation

```bash
pip install 'crewai[tools]'
```

## Tools

| Tool | Description |
|------|-------------|
| `NoryPaymentRequirementsTool` | Get payment requirements for a resource |
| `NoryVerifyPaymentTool` | Verify a signed payment before settlement |
| `NorySettlePaymentTool` | Submit payment to blockchain (~400ms) |
| `NoryTransactionLookupTool` | Look up transaction status |
| `NoryHealthCheckTool` | Check service health |

## Example

```python
from crewai import Agent, Task, Crew
from crewai_tools import NoryPaymentRequirementsTool, NorySettlePaymentTool

# Create tools
payment_tools = [
NoryPaymentRequirementsTool(),
NorySettlePaymentTool(),
]

# Create an agent with payment capabilities
payment_agent = Agent(
role="Payment Handler",
goal="Handle payment requests for premium APIs",
backstory="Expert at processing x402 payments",
tools=payment_tools,
)

# Create a task
task = Task(
description="Check what payment is needed for /api/premium/data at $0.10",
agent=payment_agent,
)

# Run
crew = Crew(agents=[payment_agent], tasks=[task])
result = crew.kickoff()
```

## Supported Networks

- **Solana** (mainnet/devnet) - sub-400ms settlement
- **Base**
- **Polygon**
- **Arbitrum**
- **Optimism**
- **Avalanche**
- **Sei**
- **IoTeX**

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `NORY_API_KEY` | No | API key for authenticated requests |

## Links

- [Nory API](https://noryx402.com)
- [GitHub](https://github.com/TheMemeBanker/x402-pay)
- [OpenAPI Spec](https://noryx402.com/openapi.yaml)
15 changes: 15 additions & 0 deletions lib/crewai-tools/src/crewai_tools/tools/nory_x402_tool/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
from .nory_x402_tool import (
NoryHealthCheckTool,
NoryPaymentRequirementsTool,
NorySettlePaymentTool,
NoryTransactionLookupTool,
NoryVerifyPaymentTool,
)

__all__ = [
"NoryPaymentRequirementsTool",
"NoryVerifyPaymentTool",
"NorySettlePaymentTool",
"NoryTransactionLookupTool",
"NoryHealthCheckTool",
]
Loading