Build Something

The network is the platform. Build whatever you want.

Pelagora gives you a mesh of Beacons, a protocol for commerce, and extension points at every layer. Build a rental app, a reverse auction engine, or something nobody's thought of yet.

It's just an API

Every Beacon exposes a simple REST API. Scaffold one, hit the endpoints, and your listing is live on the mesh in seconds. No SDK required — just HTTP. That also means your AI agent can drive the whole thing via the MCP server without you touching the terminal at all.

terminal
# Scaffold and start your Beacon
$ npx create-reffo-beacon my-surf-shop
 
Beacon created at ./my-surf-shop
Connected to Pelagora mesh
MCP server ready
 
# Publish your first listing
$ curl localhost:3000/api/refs -d '{"name": "Channel Islands Surfboard"}'
→ Ref ref_8x7k2m published to mesh (12 peers)

Want the full API reference? The Pelagora docs cover every endpoint, schema, and extension point. Or drop the Skill into your project and let your AI agent figure it out.

Your commerce, your rules
Pelagora is the network. What you build on it is up to you. Here are some starting points.
🔑

Subscription & Access Control

Gate content, services, or physical goods behind recurring offers managed entirely by your Beacon. No payment processor required — access logic lives in your Skill.

Rental Network

Rent out surfboards, cameras, tools — anything. Build availability calendars, pricing tiers, and booking flows as a Skill that any Beacon can install.

Reverse Auction Engine

Buyers post what they want. Sellers compete on price. Build the matching logic as a Skill and let the DHT handle peer discovery.

Group Buy Coordinator

Aggregate demand across the mesh. Buyers pool together, hit a threshold, unlock bulk pricing. The Skill handles commitments, deadlines, and notifications. See the PIM Protocol for data types.

🏘

Local Commerce Hub

Build a neighborhood marketplace Skill that filters by proximity. Farmers markets, garage sales, and local services — all discoverable without a central platform.

🔗

Something Entirely New

The extension points are open. Loyalty programs, escrow systems, reputation layers, AI-powered negotiation bots — if it touches commerce, you can build it.

How things fit together
Pelagora has three main surfaces you can build on. The Pelagora Skill walks your AI through all of them.

REST API API

Every Beacon exposes a local REST API for managing inventory, offers, and negotiations. Build frontends, scripts, or integrations that talk to your Beacon programmatically.

  • Items — CRUD operations for your inventory
  • Offers — Create, accept, counter, or reject price offers
  • Peers — Discover and query other Beacons on the mesh
  • Search — Full-text search across the network using Schema.org data

DHT Events Events

The Distributed Hash Table fires events when things happen on the network — new peers, incoming offers, search queries. Subscribe to these events to build reactive Skills.

  • peer:discovered — A new Beacon joined the mesh
  • offer:received — Someone wants to buy or negotiate
  • item:published — A new listing appeared on the network

MCP Server Tool

The @pelagora/mcp server lets AI agents interact with your Beacon. Register custom tools so your AI can do things specific to your app.

custom-tool.js
// Register a custom MCP tool
server.registerTool({
name: 'find-nearby-rentals',
description: 'Search for rental listings within a radius',
schema: z.object({
lat: z.number(),
lng: z.number(),
radiusKm: z.number().default(10)
}),
handler: async ({ lat, lng, radiusKm }) => {
// Query peers, filter by distance
}
)

Using the Pelagora Skill? Tell your AI "I want to build a rental Skill for Pelagora" and it will scaffold the project, set up the extension points, and walk you through the API patterns.

Ready to build on
the open sea?

Grab the Skill, hand it to your AI, and start building something new.