{"slug": "we-built-an-mcp-registry-that-agents-can-list-themselves-x402-analytics-and-tags", "title": "We Built an MCP Registry That Agents Can List Themselves — x402, Analytics, and Smart Tags", "summary": "AgentShare launched a curated MCP Registry at agentshare.dev/registry that enables autonomous AI agents to discover and submit Model Context Protocol servers via machine-readable agent.json files and x402 micropayments. The registry features owner analytics, content-aware tag suggestions, and human review to prevent spam, with listings accessible through a JSON API for agent-native discovery.", "body_md": "**AgentShare MCP Registry is a canonical, curated directory of Model Context Protocol (MCP) servers designed for autonomous AI agents and developers. It features machine-readable discovery via agent.json, owner analytics, agent-native submission via x402 micropayments, and content-aware tag suggestions.**\n\nThis post explains why we built it, how agents discover and submit listings, and what’s coming next for registry traffic intelligence.\n\nIf you ship an MCP server today, discovery is fragmented:\n\nAgents need machine-readable discovery (agent.json, JSON APIs) and human-readable trust signals (reviewed listings, clear metadata).\n\nWe built the registry at [agentshare.dev/registry](https://agentshare.dev/registry) to solve both — without becoming a spammy “list everything” directory.\n\nEvery submission starts as `pending_review`\n\n. We verify GitHub, website, and MCP endpoint URLs before publish.\n\nApproved MCPs get a canonical page:\n\n`https://agentshare.dev/registry/{id}`\n\nEach page includes share actions (X, LinkedIn, Facebook, copy link, GitHub badge snippet) so builders help distribute traffic organically.\n\nListing owners can track opens over time, referrers, client types, and countries:\n\n```\nGET /api/v1/mcp/stats/{mcp_id}?token={submission_token}\n```\n\nAgents can pay a tiny USDC micropayment to mint a scoped `registry:submit`\n\nkey, then submit metadata:\n\n```\n# Step 1: mint scoped key (x402 or full API key)\nPOST https://agentshare.dev/api/v1/registry/agent-key\n\n# Step 2: submit listing\nPOST https://agentshare.dev/api/v1/registry/submit\nX-API-Key: agshp_...scoped...\n```\n\nHuman review still applies — payment covers abuse resistance, not instant approval.\n\nWe don’t inject random DeFi tags on a clothing MCP. Tags are derived from your name, description, URLs, and optional GitHub repo topics:\n\n```\nPOST https://agentshare.dev/api/v1/registry/suggest-tags\nContent-Type: application/json\n\n{\n  \"name\": \"Fashion Inventory MCP\",\n  \"description\": \"Track apparel SKUs and size variants for retail merchandising bots.\",\n  \"category\": \"integrations\",\n  \"github_url\": \"https://github.com/you/fashion-mcp\"\n}\n```\n\nPlatform core tags (`mcp`\n\n, `ai`\n\n, `agent`\n\n) are always suggested; domain tags come from your content.\n\nAutonomous agents should not scrape HTML. Start here:\n\n```\ncurl -s https://agentshare.dev/agent.json | jq '.mcp_listings'\n```\n\nKey fields:\n\n| Field | Purpose |\n|---|---|\n`entries_json` |\nFull verified list |\n`summary_json` |\nCompact summary for scripts |\n`detail_url_pattern` |\nPublic profile URL pattern |\n`agent_submit_key_url` |\nx402 scoped key mint |\n`suggest_tags_url` |\nGEO tag suggestions |\n`listing_template` |\nOptimal metadata structure |\n\nAlso see the companion repo: `github.com/anhmtk/agentshare-mcp`\n\n`ip_hash`\n\n(SHA-256), not raw IPs`registry:submit`\n\nkeys cannot access DeFi/commerce data APIs**Is listing free?**\n\nYes for humans and agents. x402 on agent-key mint is a small anti-spam layer.\n\n**How long does review take?**\n\nTypically 24–48 hours. Save your `status_url`\n\nafter submit.\n\n**Can agents list without a human account?**\n\nYes — mint a scoped key via x402, submit via API, poll status with the submission token.\n\n**How is this different from a generic MCP directory?**\n\nCurated review, agent-native JSON discovery, owner analytics, and GEO tooling — not an unmoderated dump.\n\n**What analytics do owners get?**\n\nViews/opens over time, top referrers, user-agent labels, country breakdown (aggregated).\n\nFree listings grow the network. Aggregate traffic intelligence is the long-term layer:\n\nWe’re capturing cross-listing traffic internally first (admin aggregate dashboard + TXT/PDF export) before publishing any public datasets.\n\n`POST /api/v1/registry/suggest-tags`\n\nIf you’re building MCP servers for agents, we’d love to see your listing. The agentic web needs directories that speak both human and machine — we’re shipping one step at a time.\n\nBuilt by [AgentShare](https://agentshare.dev) — Solana DeFi intelligence + curated MCP registry.\n\nMaintainer: [@anhmtk](https://dev.to/anhmtk).", "url": "https://wpnews.pro/news/we-built-an-mcp-registry-that-agents-can-list-themselves-x402-analytics-and-tags", "canonical_source": "https://dev.to/anhmtk/we-built-an-mcp-registry-that-agents-can-list-themselves-x402-analytics-and-smart-tags-4amg", "published_at": "2026-07-28 15:33:42+00:00", "updated_at": "2026-07-28 15:34:44.272125+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "ai-infrastructure", "artificial-intelligence"], "entities": ["AgentShare", "agentshare.dev", "MCP Registry", "Model Context Protocol", "Solana", "GitHub"], "alternates": {"html": "https://wpnews.pro/news/we-built-an-mcp-registry-that-agents-can-list-themselves-x402-analytics-and-tags", "markdown": "https://wpnews.pro/news/we-built-an-mcp-registry-that-agents-can-list-themselves-x402-analytics-and-tags.md", "text": "https://wpnews.pro/news/we-built-an-mcp-registry-that-agents-can-list-themselves-x402-analytics-and-tags.txt", "jsonld": "https://wpnews.pro/news/we-built-an-mcp-registry-that-agents-can-list-themselves-x402-analytics-and-tags.jsonld"}}