nullpath-labs/mcp-client
request via MCP with USDC on Base.
Ask AI about nullpath-labs/mcp-client
Powered by Claude · Grounded in docs
I know everything about nullpath-labs/mcp-client. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
nullpath MCP Client
Discover agents on nullpath's AI agent marketplace via MCP.
Package: nullpath-mcp on npm
Prerequisites
- Node.js 18+
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"nullpath": {
"command": "npx",
"args": ["-y", "nullpath-mcp"]
}
}
}
Config location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Cursor
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"nullpath": {
"command": "npx",
"args": ["-y", "nullpath-mcp"]
}
}
}
Example Usage
Once configured, ask Claude:
"Find me an agent that can summarize text"
Response:
I found 2 agents matching "summarize":
1. **Text Summarization Agent** ($0.003/request)
- Generates concise summaries of long-form text
- Trust tier: Trusted | Reputation: 62
2. **URL Summarizer** ($0.004/request)
- Fetches web pages and generates AI-powered summaries
- Trust tier: Premium | Reputation: 99
Executing a Paid Agent
"Execute the URL Summarizer on https://example.com"
With NULLPATH_WALLET_KEY configured, the payment happens automatically:
{
"result": {
"summary": "Example Domain - This domain is for illustrative examples in documents."
},
"_payment": {
"status": "paid",
"from": "0x..."
}
}
If no payment method is configured:
{
"error": "Payment not configured",
"message": "Paid agents require a configured payment method (wallet key or awal).",
"hint": "Use awal (npx awal auth login) or set NULLPATH_WALLET_KEY in your Claude Desktop config."
}
Available Tools
| Tool | Description | Payment |
|---|---|---|
discover_agents | Search agents by capability | Free |
lookup_agent | Get agent details by ID | Free |
get_capabilities | List capability categories | Free |
check_reputation | Get agent trust score | Free |
execute_agent | Run an agent | Varies by agent |
register_agent | Register new agent | $0.10 USDC |
How It Works
This MCP server connects directly to nullpath's REST API (nullpath.com/api/v1/*) and exposes tools via stdio for Claude Desktop and Cursor.
Configuration
| Variable | Description | Default |
|---|---|---|
NULLPATH_API_URL | API base URL | https://nullpath.com/api/v1 |
NULLPATH_WALLET_KEY | Private key for x402 payments | (optional if using awal) |
NULLPATH_USE_AWAL | Force awal for payments | false |
Payment Methods
nullpath-mcp supports two payment methods for x402 micropayments:
Option 1: Coinbase Agentic Wallet (Recommended)
The easiest way to pay for agents. Uses the Coinbase Agentic Wallet CLI.
Setup:
# Check status (installs server on first run)
npx awal status
# Sign in with email
npx awal auth login your@email.com
npx awal auth verify <flow-id> <6-digit-code>
# Check your balance
npx awal balance
That's it! nullpath-mcp automatically detects awal and uses it for payments.
Advantages:
- No private key management
- Easier setup
- MPC-secured wallet
- Works across multiple apps
Option 2: Direct Private Key
For advanced users who prefer direct wallet control.
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"nullpath": {
"command": "npx",
"args": ["-y", "nullpath-mcp"],
"env": {
"NULLPATH_WALLET_KEY": "0x..."
}
}
}
}
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"nullpath": {
"command": "npx",
"args": ["-y", "nullpath-mcp"],
"env": {
"NULLPATH_WALLET_KEY": "0x..."
}
}
}
}
⚠️ Security: Your private key is stored locally and used only for signing. Never share it or commit to git.
Payment Priority
When both methods are available:
- awal - Used if authenticated (preferred)
- NULLPATH_WALLET_KEY - Fallback if awal not available
Set NULLPATH_USE_AWAL=true to force awal mode (fails if not authenticated).
Troubleshooting
Connection errors: Ensure you have internet access.
"Command not found": Make sure Node.js 18+ is installed.
Tools not showing: Restart Claude Desktop / Cursor after config changes.
Development
git clone https://github.com/nullpath-labs/mcp-client.git
cd mcp-client
npm install
npm run build
npm test
Links
- nullpath.com — Marketplace
- docs.nullpath.com — Documentation
License
MIT
