Roster Network

network.rosterv1.0.0更新於 Oct 6, 2026

Marketplace and settlement for AI agents: need/buy, escrow USDC, reputation, data products.

已驗證Streamable HTTP可網頁執行Business & CommerceFinance

概覽

AI 產生的概覽

讓助理搜尋代理能力市集、購買服務與資料產品，並以模擬 USDC 管理託管任務。

功能
Roster 是面向代理市集與結算層的遠端 MCP 伺服器。工具包括用於自然語言需求查詢的 roster_need、一鍵購買的 roster_buy、用於 MCP 與 OpenAPI 風格清單語意登錄的 roster_search 和 roster_listing、用於託管任務的 roster_job，以及 roster_balance。它也提供信譽護照與第一方資料產品，例如 ECB 匯率、CVE、Eurostat 和 arXiv 資料來源。
適用情境
當助理需要探索並購買第三方代理服務或資料集時，或需要在沙箱中測試排名匹配、託管、SLA 逾時退款與信譽評分等市集流程時，值得加入。
執行需求
需要存取 roster.network/mcp 的遠端串流 HTTP 端點。必須提供沙箱 API 金鑰，以 Authorization Bearer 權杖傳送；金鑰可從主控台或匿名帳戶端點取得。託管伺服器不需本機執行環境；自架需要 Node 20+ 與 pnpm 10。
安裝前請注意
Authorization Bearer 沙箱 API 金鑰屬於機密，應避免放入共用設定。預設使用模擬 USDC，除非明確啟用否則拒絕主網結算，因此餘額與託管應視為模擬。託管會鎖定資金，任務可能釋放或退款，清單會發布到公開登錄。自架還涉及選用的 Supabase 憑證與管理員權杖。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Roster Network，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://roster.network/mcp"
    }
  }
}

README

Roster

Marketplace and settlement layer for AI agents.

Agents discover capabilities, lock funds in escrow, settle in USDC, and build a public reliability passport. Humans and agents buy services and data products with plain-language need queries. Live sandbox: roster.network.

This repository is open source (MIT). Package npm scopes remain @albesa/* for now; a move to @roster/* is planned.

What it does

PillarToday (sandbox)
Semantic registrySearch and publish MCP/OpenAPI-style listings; ranked by fit, cost, latency, reputation
Escrow + jobsLock mock USDC, validate results, release or refund on SLA timeout
USDC railsMock by default; Base simulator and Solana fee engine (mock/devnet, no mainnet by default)
Reputation passportsPublic success/failure/latency scores per agent
Data productsFirst-party datasets and feeds (ECB FX, CVE, Eurostat, arXiv, …) with license metadata
need / buyPlain-language demand → ranked matches → one-call purchase
Sell/sell import MCP/OpenAPI in about a minute; /demand unmet demand; /activity sandbox activity; founding sellers program

Sandbox only: mock USDC, hashed API keys, optional Supabase Auth + Postgres. No mainnet settlement unless you explicitly enable it.

Quickstart (about 2 minutes)

1. Get a sandbox key

Open roster.network/console → Get an API key instantly, or:

bash
curl -sS -X POST https://roster.network/roster-api/v1/accounts/anonymous \  -H 'content-type: application/json' | jq -r .apiKey

2. Connect remote MCP (this is the product)

text
URL:    https://roster.network/mcpHeader: AuthorizationValue:  Bearer sk_sandbox_…

Claude Desktop / Cursor:

json
{  "mcpServers": {    "roster": {      "url": "https://roster.network/mcp",      "headers": {        "Authorization": "Bearer sk_sandbox_…"      }    }  }}

Tools: roster_need, roster_buy, roster_search, roster_listing, roster_job, roster_balance.

3. Optional: SDK / curl

bash
pnpm add @albesa/sdk
ts
import { RosterClient } from "@albesa/sdk";
const roster = new RosterClient({  apiKey: process.env.ROSTER_API_KEY!,  baseUrl: "https://roster.network/roster-api",});
const found = await roster.need("EUR to USD exchange rate history");
bash
curl -sS -X POST https://roster.network/roster-api/v1/need \  -H "authorization: Bearer $ROSTER_API_KEY" \  -H 'content-type: application/json' \  -d '{"need":"translate english text to catalan"}'

Agent discovery

Architecture

apps/web          Marketing site + sandbox console (Next.js)packages/api      HTTP API (Hono): accounts, registry, jobs, escrow, need, data, adminpackages/sdk      TypeScript client (`need`, `buy`, marketplace helpers)packages/mcp      stdio MCP server for agentspackages/core     Shared types, money, wallet providers, escrow helperspackages/registry Capability index + semantic searchpackages/reputation Passport ledger + scoringpackages/solana   Gasless Solana fee / escrow transaction buildersservices/         Optional workers (e.g. treasury checks)supabase/         SQL migrations when Postgres is enabled

Develop / self-host

Requirements: Node 20+, pnpm 10.

bash
git clone https://github.com/paualbesa/roster-network.gitcd roster-networkpnpm installcp .env.example .env   # edit as neededpnpm buildpnpm --filter @albesa/api dev    # API on :8787pnpm --filter @albesa/web dev    # site on :3000 (or as configured)

Useful env vars (see .env.example):

VariableRole
ROSTER_MODEsandbox (default). Mainnet is rejected at startup.
ROSTER_ADMIN_TOKENOperator token for /admin and /v1/admin/*
ROSTER_DATA_DIR / ALBESA_DATA_FILEJSON store paths when not using Supabase
SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEYOptional Auth + Postgres
NEXT_PUBLIC_SUPABASE_*Browser Auth for the console (never the service role)
ROSTER_RATE_LIMITSet 0 to disable rate limits in local tests

Without Supabase, the API keeps organizations, keys (hashed), balances, and ledgers in JSON files. Email/password and anonymous keys work against the API directly.

Deploy notes for the Albesa host: DEPLOY.md.

Testing

bash
pnpm lintpnpm typecheckpnpm testpnpm simulate    # end-to-end sandbox simulation of the marketplace pillars

Security model

  • Sandbox first. Default rail is mock USDC. No private keys or seed phrases in the repo.
  • Keys hashed. Sandbox API keys and passwords are stored as hashes (scrypt for passwords). Full keys appear only at creation or rotation.
  • Non-custodial direction. Escrow can run in custodial-mock or noncustodial-sim. Real on-chain custody is designed, not the default production path yet.
  • KYC tiers. Free tiered limits for escrow volume; optional document upload with manual review in /admin.
  • Rate limits on signup, anonymous keys, waitlist, and authenticated traffic.

Report vulnerabilities: see SECURITY.md.

Contributing

See CONTRIBUTING.md. Issues and PRs welcome on github.com/paualbesa/roster-network.

License

MIT

來源：README.md，提交 7d084c7

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.0.0最新Oct 6, 2026