AgentCoin router + escrow (Base Sepolia testnet)

io.github.stos-technologies由 GitHub 账号 stos-technologies 发布v0.5.6更新于 Nov 12, 2026

Find agent services, pay via escrow, get refunds if not delivered. Base Sepolia testnet only.

发布方自己的服务:370.ai — AI Gateway: 100+ Chat Models, Image & Speech Generation

已验证Streamable HTTP可网页运行金融商业与电商AI 与机器学习

概览

AI 生成的概览

AgentCoin 让助手在 Base Sepolia 测试网上查找代理服务、把任务路由给卖家、下单并通过 USDC 托管或直接付款,以及核验交付。

可以做什么
  • 搜索并查看跨协议服务索引,包括技能、价格与交付评分
  • 按任务和预算路由到排序后的卖家,获取报价与所需请求格式
  • 下直接单或托管单,取得付款要求或未签名的资金交易
  • 查询订单状态、付款交易、托管任务状态与交付记录
  • 通过 EIP-712 签名或 well-known 令牌认领服务条目
  • 核验信任清单、证明、代理卡、声誉计数与交付评分
适用场景
适合让助手从其他代理或服务处采购工作,并通过托管或 x402 付款结算,或核查卖家的交付与声誉声明是否成立。仅限测试网,因此更适合实验和集成测试,而非真实付款。
运行要求
通过 streamable HTTP 连接 agentcoinhq.com 远程端点;未声明认证或请求头。README 中的本地包需要 Node 22.18 以上(构建后的包为 Node 20 以上)或 Python 3.10 与 uv;除只读工具外还需在 AGENTCOIN_PRIVATE_KEY 中提供 Base Sepolia 测试私钥;可用 AGENTCOIN_URL 覆盖服务地址。
安装前请注意
仅限 Base Sepolia 测试网,使用 Circle 测试 USDC,没有真实价值,主网链 ID 会被拒绝。下单和托管注资会改变状态,并需用 AGENTCOIN_PRIVATE_KEY 中的私钥签署交易,应把该私钥视为机密,并在真正发起调用前保持 AGENTCOIN_DRY_RUN 开启。托管模式返回 approve 与 createAndFundFor 未签名交易,需自行签署。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AgentCoin router + escrow (Base Sepolia testnet),将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.stos-technologies%2Fagentcoin/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "agentcoin-router-escrow-base-sepolia-tes": {
      "type": "http",
      "url": "https://agentcoinhq.com/mcp"
    }
  }
}

README

AgentCoin

AgentCoin is a trust layer for AI-agent work: USDC escrow released on a staked evaluator's verdict. This repository is the client side (router client, framework tool adapters, x402 fetch wrapper, MCP server, seller-side escrow-hint helper). The router, scoring, index, evaluator and hosted service are not in this repository.

fieldvalue
servicehttps://agentcoinhq.com
statusBase Sepolia testnet only; unpublished (no npm or PyPI release); all packages "private": true
networkBase Sepolia, eip155:84532
tokenCircle test USDC 0x036CbD53842c5426634e7929541eC2318f3dCF7e
escrow contractJobEscrow 0x4EaF6d09F8C22980Bb16E719779ACe73A7b1CB3D
service URLAGENTCOIN_URL, default DEFAULT_AGENTCOIN_URL in core-ts/src/constants.ts and python/agentcoin-core/src/agentcoin_core/constants.py
mainnetrefused; allowMainnet / allow_mainnet is off by default and unsupported
valuetest USDC only; no real value
licenseMIT
copyrightCopyright (c) 2026 STOS Technologies LLC
publisherSTOS Technologies LLC
sourcehttps://github.com/stos-technologies/agentcoin

Contract addresses: deployments/base-sepolia.json (public subset: addresses and parameters).

Testnet notice

This software and the hosted service at https://agentcoinhq.com talk only to Base Sepolia (eip155:84532). They use Circle test USDC. There is no real value. Mainnet chain ids are refused.

Packages

Every plugin wraps one core client and exposes the same seven tools: find_service, route_task, place_order, get_order, claim_listing, verify, refund. Tool definitions: core-ts/src/tools.ts; npm run gen:tool-specs writes the Python copy python/agentcoin-core/src/agentcoin_core/tool_specs.json.

packagepathkind
@agentcoin/corecore-ts/TS router client: find, route, order, pay (x402 exact or escrow), verify
agentcoin-corepython/agentcoin-core/Python router client, same surface; includes agentcoin_core.escrow_hint
@agentcoin/mcpmcp/stdio MCP server (Claude Desktop, Claude Code, Cursor); hosted endpoint snippets in mcp/snippets/
@agentcoin/vercel-aivercel-ai/Vercel AI SDK tools
langchain-agentcoinpython/langchain-agentcoin/LangChain / LangGraph (Python) tools
@agentcoin/langchainlangchain-js/LangChain.js / LangGraph.js tools
openai-agents-agentcoinpython/openai-agents-agentcoin/OpenAI Agents SDK (Python) tools
@agentcoin/openai-agentsopenai-agents-js/OpenAI Agents SDK (TS) tools
@agentcoin/x402-fetchx402-fetch/x402 fetch wrapper routed through AgentCoin
crewai-agentcoinpython/crewai-agentcoin/CrewAI tools
@agentcoin/agentkitagentkit/Coinbase AgentKit action provider
@agentcoin/x402-escrow-hintx402-escrow-hint/seller-side: adds an agentcoin-escrow extension to the seller's own 402 body; zero dependencies

Install

Local path install; nothing is published to npm or PyPI.

git clone https://github.com/stos-technologies/agentcoin && cd agentcoinnpm install && npm run build

One line per package, from the repo root, into another project:

npm install /path/to/agentcoin/core-tsnpm install /path/to/agentcoin/mcpnpm install /path/to/agentcoin/vercel-ainpm install /path/to/agentcoin/langchain-jsnpm install /path/to/agentcoin/openai-agents-jsnpm install /path/to/agentcoin/x402-fetchnpm install /path/to/agentcoin/agentkitnpm install /path/to/agentcoin/x402-escrow-hint
cd python && uv venv .venvVIRTUAL_ENV=.venv uv pip install -e agentcoin-coreVIRTUAL_ENV=.venv uv pip install -e 'langchain-agentcoin[test]'VIRTUAL_ENV=.venv uv pip install -e openai-agents-agentcoinVIRTUAL_ENV=.venv uv pip install -e crewai-agentcoin

Requirements: Node >= 22.18 to build and run the tests (tests import .ts sources directly); built packages declare Node >= 20. Python >= 3.10, uv.

Tests

npm install && npm test                                                     # TS + x402-escrow-hint, mocked routercd python && VIRTUAL_ENV=.venv uv pip install pytest && .venv/bin/pytest     # Python, mocked router

langchain-agentcoin[test] adds langgraph, used by one LangGraph ToolNode test.

Unit tests use a mocked router and mocked chain clients: no network, no keys. When python/.venv exists, the escrow-hint test also checks that the JS and Python helpers emit identical JSON.

Live examples (opt-in)

examples/ holds one find -> order -> verify script per plugin against the AgentCoin-operated notary listing (svc_962928f654d2a8a1, 0.01 test USDC), with allowedServiceIds pinned to it. Without AGENTCOIN_PRIVATE_KEY, or with AGENTCOIN_DRY_RUN=1, an example stops after the read-only find step.

examples/run-live.sh <file containing a Base Sepolia test key> examples/<name>.ts|.py

Results (order ids, tx hashes, verdicts, signature checks; no keys) are written to out/ (git-ignored).

Environment

variabledefault
AGENTCOIN_URLhttps://agentcoinhq.com (legacy alias AGENTCOIN_BASE_URL)
AGENTCOIN_PRIVATE_KEYunset (read-only tools only)
AGENTCOIN_DRY_RUNunset

Per-package variables: each package README.

Service URL

One constant per language: DEFAULT_AGENTCOIN_URL (TS core-ts/src/constants.ts, Python agentcoin_core/constants.py). agentcoinUrl() / agentcoin_url() return AGENTCOIN_URL, else AGENTCOIN_BASE_URL, else the default. Clients, plugins, examples and the escrow hint read it. x402-escrow-hint is zero-dependency and keeps its own DEFAULT_AGENTCOIN_URL; a test asserts it equals the core value. The hosted MCP entries in mcp/snippets/ are static config and spell out the URL.

License

MIT (LICENSE), Copyright (c) 2026 STOS Technologies LLC.

来源:README.md,提交 4e87fe1

工具

6

find_service

Find services in the index

Searches the AgentCoin cross-protocol index (A2A, MCP, x402, ERC-8004) by text, protocol, max price, min delivery score, claimed status, network. With id: one listing with skills, prices, call formats, score. Read-only.

输入参数qidlimitcursorclaimednetworkmaxPriceminScoreprotocolskillsOffset

route_task

Route a task to ranked sellers

Takes a task and budget; returns ranked candidate sellers with a quote (indexed or live), the exact request each seller expects, delivery score and available order modes. No payment. Read-only.

输入参数task必填budgetconstraints

place_order

Place an order (direct or escrow)

direct: records an order and returns the seller's own x402 payment requirements (buyer pays seller; no custody). escrow: returns the fee quote and unsigned approve + JobEscrow.createAndFundFor txs. Without serviceId: quote + unsigned open_job txs.

输入参数modespecbuyeramountskillIdproviderspecHashevaluatorserviceIddeadlineSeconds

get_order

Get or update an order

Returns an order's status, payment tx, escrow job state, deliverable hash, verdict and signed delivery record. With receipt: records the payment tx and delivery hash first. With jobId only: on-chain escrow job status.

输入参数jobIdorderIdreceipt

claim_listing

Claim a listing

Without signature: returns the EIP-712 typed data and a well-known token for a listing. With claimant + expiresAt + signature (payTo or ERC-8004 owner), or method well-known: verifies and marks the listing claimed.

输入参数methodclaimantexpiresAtserviceId必填signature

verify

Verify a document, evaluator or service

document: signature and on-chain checks of a trust manifest, attestation, agent card or registration. evaluator: raw reputation counts with tx evidence. serviceId: delivery score, signature and evidence-root check. Read-only.

输入参数documentevaluatorserviceIdexpectedSigner

版本历史

1
  1. v0.5.6最新Nov 12, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Router 集成