mcpField
S
Synmerco

Synmerco

Local
github.com/synmercoFinance0Updated 28w ago

About Synmerco

Synmerco provides escrow and trust services for AI agent commerce, aimed at agents and services that need managed payments, verification, and reputation. It combines escrow, insurance, on-chain reputation, evaluation, and spending controls across four blockchains.

Key features

  1. 01Escrow payments and automatic payouts
  2. 02Insurance included with each escrow
  3. 03ERC-8004 on-chain reputation
  4. 04Third-party evaluation and disputes
  5. 05Per-transaction and periodic spending caps
  6. 06Collateral staking and referral earnings

Use cases

  1. 01Release funds after work is verified
  2. 02Record on-chain reputation for agent transactions
  3. 03Limit an agent’s daily or per-transaction spending
  4. 04Earn from referring other agents

MCP support

The README lists MCP as a compatible protocol but does not specify MCP-exposed functionality.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"integration": {
"command": "npx",
"args": [
"-y",
"@synmerco/mcp-server"
]
}
}
}
Run commandnpx -y @synmerco/mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@synmerco/mcp-server

Tools

38

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
didstringYes

Details

From the project README

Synmerco - The Trust Standard for AI Agent Commerce

Escrow + Insurance + On-Chain Reputation + Auto-Payouts across 4 blockchains. 3.25% fee (fiat or USDC — save ~3% with crypto). 536/536 tests. Just Synmerco it.

Tests Chains ERC-8004 Fee

Quick Start (60 seconds)

# 1. Get an API key (no signup needed)
curl -X POST https://synmerco-escrow.onrender.com/v1/api-keys/register \
  -H "Content-Type: application/json" \
  -d '{"ownerDid": "did:key:your-did", "label": "my-agent"}'

# 2. Create an escrow
curl -X POST https://synmerco-escrow.onrender.com/v1/escrows \
  -H "Authorization: Bearer sk_syn_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"buyerDid": "did:key:buyer", "sellerDid": "did:key:seller", "amountCents": 5000}'

# Buyer pays via Stripe checkout URL. Seller submits proof. Auto-release in 72h. Done.

Python SDK

pip install git+https://github.com/synmerco/integration.git
from synmerco import SynmercoClient
client = SynmercoClient(api_key="sk_syn_YOUR_KEY")
escrow = client.create_escrow(buyer_did="did:key:buyer", seller_did="did:key:seller", amount_cents=5000)
print(escrow["checkoutUrl"])

5 Groundbreaking Features (Industry Firsts)

FeatureWhat It DoesStandard
ERC-8004 ReputationEvery escrow outcome dual-written to ERC-8004 ReputationRegistry - readable by 129,000+ agentsERC-8004
Third-Party EvaluatorsNeutral AI agents/oracles verify work before releaseERC-8183
Spending LimitsPer-transaction, daily, weekly, monthly caps auto-enforcedAP2
Collateral StakingAgents post bonds. 10% auto-slashed on disputeARS
ACP/UCP CompatibleProduct catalog + service discovery for OpenAI/Stripe and Google protocolsACP + UCP

Core Platform

FeatureDetails
EscrowFunds locked until work verified. 4 chains live.
InsuranceSynmerco Shield - $1,000 per escrow, included free
ReputationDual-write to ERC-8004 + SynmercoReputation on all 4 chains
Auto-PayoutsSellers paid instantly via Stripe Connect
Auto-Release72-hour auto-release protects sellers
ReferralsEarn 0.25% on every escrow from agents you refer
Fee3.25% - best value in AI agent commerce (best value — 3.25% includes escrow + insurance + reputation + referral income. OpenAI+ACP charges ~7% for discovery alone)

Live Chains

ChainChain IDERC-8004 Agent IDStatus
Base845345119Live
Arbitrum42161821Live
Polygon137433Live
Optimism10491Live

Escrow Contract: 0x5fC3995738DFC522e877DF3311bE6ecea60299Fc (same on all chains)

API Endpoints (48+)

Escrow Lifecycle

POST /v1/escrows                    Create escrow + Stripe checkout
GET  /v1/escrows/:id                Get escrow details
POST /v1/escrows/:id/fund           Fund (buyer only)
POST /v1/escrows/:id/submit-proof   Submit proof (seller only)
POST /v1/escrows/:id/evaluate       Evaluator approve/reject
POST /v1/escrows/:id/release        Release funds
POST /v1/escrows/:id/dispute        Raise dispute

Spending Limits

POST   /v1/spending-limits          Set caps
GET    /v1/spending-limits/:did     View limits + usage
DELETE /v1/spending-limits/:did     Remove limits

Collateral Staking

POST /v1/collateral/stake           Deposit bond
GET  /v1/collateral/:did            Status + events
GET  /v1/collateral/info            ARS program info

Referral Program

POST /v1/referrals/register         Register as referrer
POST /v1/referrals/link             Link referred agent
GET  /v1/referrals/stats/:did       Stats
POST /v1/referrals/request-payout   Request payout

Protocol Discovery

GET /v1/acp/catalog                 ACP product catalog
GET /v1/ucp/services                UCP service discovery
GET /.well-known/agent.json         A2A discovery
GET /v1/synmerco                    Platform overview

Full docs with all 48+ endpoints ->

Protocol Compatibility (12)

ERC-8004 | ERC-8183 | ACP (OpenAI/Stripe) | UCP (Google) | A2A | MCP | x402 | ARS | AP2 | REST | OpenAPI 3.0 | Python SDK

Security (15 layers)

API key auth | DID verification | Stripe PCI-DSS Level 1 | $100K cap | Integer validation | Idempotency keys | CORS restricted | Rate limiting (10 keys/DID) | Hash-chained audit log | Collateral slash caps | Evaluator guards | Referral fraud prevention | Payout aging | Webhook signatures | Separated wallets

Referral Program

Earn 0.25% on every escrow from agents you refer. No cap. Auto-tracked. Paid via Stripe.

curl -X POST https://synmerco-escrow.onrender.com/v1/referrals/register \
  -H "Authorization: Bearer sk_syn_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"referrerDid": "did:key:your-did"}'
# Share your ref_ code. They earn. You earn. Everyone earns.

Links

ResourceURL
Docssynmerco.com/docs
Playgroundsynmerco.com/playground
Dashboardsynmerco.com/dashboard
OpenAPIsynmerco.com/openapi.json
Agent Manifestsynmerco.com/agent-manifest.json
ACP Catalogsynmerco-escrow.onrender.com/v1/acp/catalog

License

MIT


The trust standard for AI agent commerce. Just Synmerco it.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.