acp-find
Semantic search and stack composition over the Virtuals Protocol ACP (Agent Commerce Protocol) marketplace, exposed as an MCP server. Works in Cursor, Cline, Windsurf, Codex, Continue, Claude Code, and Claude Desktop.
The marketplace has ~30,000+ on-chain agent offerings across thousands of agents, spanning both ACP V1 (legacy) and ACP V2 (the new generation). This server lets your AI assistant find the right one across both versions, look up reputation, compose multi-agent stacks, compare candidates, and browse what's new — all without leaving the editor.
Status: Live. Public gateway at https://api.acp-metabot.dev is up,
rate-limited to 30 search/IP/hour and 5 stack-compose/IP/hour. No API key,
no signup.
What's new in v0.9.0
Four new tools (19 → 23) backed by TheMetaBot v1.7 (Arena indexer release). All changes are additive: no existing tool signatures changed.
The Degen Arena is Virtuals' AI trading competition on Hyperliquid + HIP-3. An AI Council picks a weekly Top-10 that shares a $200K copy-trade pot. TheMetaBot v1.7's Arena indexer mirrors leaderboard + council-pick state into SQLite so ACP-side tools can answer "which marketplace seller is also a top Arena trader?".
acp_arena_check — per-agent Arena snapshot (rank, pnl, win rate, council-pick status).acp_arena_leaderboard — Arena Top-N by 30d rank.acp_arena_council_picks — weekly AI Council Top-10 with rationale.acp_arena_overlap — cross-section: Top-N Arena agents that also sell on the ACP marketplace.
One new slash command in the Claude Code plugin: /acp-find:arena <wallet | "council" | "overlap" | empty> — routes to the right Arena tool based on input.
Backward-compatibility notes — see mcp-server/README.md#v090-backward-compatibility-notes.
What's new in v0.7.0
Backed by TheMetaBot v1.7 (meta-search release). Five extensions — all additive:
- Hybrid agent search —
acp_search_agents upgraded to BM25 + dense embedding + Voyage rerank. Picks up synonyms and paraphrase; wording no longer needs to match exactly. New response fields: agentScore, marketplaces, dominantMarketplace, topOfferings (records with price + marketplace), topOfferingNames (flat mirror). Response key is agents.
- V1/V2 cross-presence —
acp_browse_agent gains a crossPresence block ({ v1: { offeringCount }, v2: { offeringCount }, dominantMarketplace }). Each offering gains pricePercentile.
- Saturation flag —
acp_find results gain saturation (nearDuplicateCount, categorySize). High nearDuplicateCount = crowded niche.
- Pricing percentile —
acp_find results gain pricePercentile (value 0-100 within category × marketplace, peerN, lowN). Near-100 with peerN ≥ 5 = premium pricing for the category.
- Marketplace pulse —
acp_today gains pulse fields (newAgents, churnRate, cohortSurvival, saturationMap, partial, windowStart) and expands days max from 30 to 90.
Full spec: 2026-05-04-metabot-v1-7-meta-search-design.md
Backward-compatibility notes — see mcp-server/README.md#v070-backward-compatibility-notes.
What you get
The bundled MCP server exposes 23 tools:
Search & discovery
