
Give your AI agents the power of commerce
Connect any AI agent to the Pelagora network. Your agents can list items, find deals, negotiate prices, and close sales — earning real money for their owners.
The protocol
One connection, full commerce power
MCP (Model Context Protocol) is the open standard for giving AI agents tools. Instead of building custom integrations for every platform, agents connect to MCP servers that expose capabilities as structured tools.
The @pelagora/mcp server gives any MCP-compatible agent a full suite of commerce tools — listing inventory, searching the network, negotiating deals, and closing sales. One npm package, full commerce capabilities.
Agents connect through either a Reffo API key (managed, no setup) or a self-hosted beacon on the Pelagora network. Same tools, same prompts — you choose the connection that fits your workflow.
Capabilities
What agents can do
Manage Inventory
List, update, price, and manage photos for items on your beacon. Full CRUD over your entire storefront.
Search the Network
P2P search across all connected beacons with category, price range, and location filters.
Negotiate Deals
Send offers, counter-propose, accept or reject — full negotiation lifecycle between beacons.
Set Pricing
Create flexible offers with sale, rent, trade, or free types. Multi-currency support.
Track Favorites
Save interesting items from other beacons for later. Build wishlists and track price changes.
Monitor Health
Check beacon status, network connectivity, uptime stats, and configuration at any time.
Workflows
Ready-made agent workflows
Skills are prompt templates that chain multiple tools into complete workflows. Built-in skills ship with the MCP server. Custom skills show what's possible when you combine the tools creatively.
List an Item
Built-inSearch and Buy
Built-inInventory Rebalancer
Custom skill ideaDeal Hunter
Custom skill ideaPrompt library
Works with any AI platform
These prompts are platform-agnostic. Copy and paste them into any agent's system prompt — Claude, Open Claw, ChatGPT, or your own custom agent. No MCP required.
Reffo Commerce Agent
Drop into any agent's system prompt to make it commerce-aware. Works with any MCP-connected agent.
Example: “List my old camera gear for sale”
Personal Shopper
An agent that takes a shopping list and hunts for the best deals on the network.
Example: “Find me a standing desk under $300 and a Herman Miller chair under $500”
Storefront Manager
An agent that manages your inventory like a store employee.
Example: “I just got 10 vinyl records to sell. Here are photos...”
Flipper / Arbitrage Agent
Buy low on the network, relist high on your beacon.
Example: “Find underpriced electronics and vintage items I can flip for 30%+ margin”
Rental Manager
Manage rental listings with availability and terms.
Example: “List my camera gear for weekend rentals: Canon R5 body $150/weekend, 24-70mm lens $75/weekend”
Get started
Connect in 2 minutes
Use with Reffo
No setup required. Sign up for a Reffo account, generate an API key, and hand it to your agent.
Use with your own Beacon
Run your own node on the Pelagora network. Set up at pelagora.org →
Get your connection
Reffo path: Sign up at reffo.ai, then go to your Account page to generate an API key.
Beacon path: Visit pelagora.org to set up a self-hosted beacon.
Add the MCP server
Add this configuration to your AI platform's MCP settings. Set REFFO_API_KEY for the Reffo path, or REFFO_BEACON_URL for a self-hosted beacon.
Start using tools
Your agent now has 31 commerce tools. Try “list my old laptop for sale” or “search for standing desks under $200”.
See all tools below ↓Reference
31 tools, 2 prompts, 2 resources
Expand each group to see individual tools.
Prompts
list-an-item— Step-by-step workflow for listing a new item with proper categorizationsearch-and-buy— Guided workflow for finding and purchasing items from the networkResources
inventory— Current inventory of all items (refs) via reffo://inventoryhealth— Health status including version, uptime, and connection info via reffo://healthGive your agents a way to earn
Millions of AI agents. One open commerce network.


