How to Maximize Your Tool's Discovery
Learn how to make your AI tool visible to agents and developers. Covers listing optimization, badges, directory registration, registry submission, and content marketing for MCP tools.
In this guide
Optimize Your Listing
Your SettleGrid listing is the first thing agents and developers see. Write a clear, specific title that includes what your tool does and what category it serves — "Real-Time Weather API for AI Agents" converts better than "Weather Tool." The description should lead with the primary value proposition, include concrete use cases, and specify what input/output formats your tool supports.
Add a detailed README.md to your project repository and link it from your listing. The README should include a quick-start code example, input/output schema documentation, pricing explanation, and performance benchmarks. Agents use README content to decide whether to integrate your tool, and developers use it to evaluate alternatives. A comprehensive README is the highest-ROI investment you can make in discovery.
Tag your listing with accurate categories and keywords. SettleGrid uses these for search ranking and category page placement. Use specific keywords ("geolocation enrichment") rather than generic ones ("data tool"). Include the programming languages your tool works best with, the industries it serves, and the specific problems it solves. The more precise your tags, the more qualified your discovery traffic will be.
Register in Directories
Beyond the SettleGrid marketplace, register your tool in every relevant directory. The MCP ecosystem is still young, so directories have low competition and high visibility. Start with the official MCP server registry, Awesome MCP lists on GitHub, and developer tool aggregators like Product Hunt and DevHunt.
Create a .well-known/mcp/server-card.json file in your deployment (the SettleGrid templates include one). This file follows the MCP Discovery specification and allows AI agents to discover your tool by probing your server's well-known URL. Any agent that supports MCP Discovery will find your tool automatically if it knows your server's base URL.
Register with the SettleGrid Discovery API by publishing your tool (this happens automatically when you run npx settlegrid publish). The Discovery API is a public, unauthenticated endpoint that AI agents query to find tools by category, capability, and pricing. It is the primary discovery channel for agent-to-agent workflows and accounts for the majority of new consumer acquisition on the platform.
Submit to MCP Registries
MCP registries are centralized directories that AI agents query to find tools. Submit your tool to every registry you can find. The SettleGrid Discovery Server (npx @settlegrid/discovery) is one such registry, but others exist: the MCP Registry (mcp-registry.org), the Anthropic MCP Hub, and community-maintained registries on GitHub.
When submitting, ensure your tool's metadata is complete and accurate. Registries rank tools by metadata quality, and incomplete submissions get buried. Include a comprehensive description, accurate capability tags, pricing information, latency benchmarks, and a link to your documentation. Some registries support "verified" badges for tools that pass automated testing — apply for verification wherever available.
Keep your registry listings up to date. When you add new methods, change pricing, or improve performance, update your registry entries. Stale listings with outdated pricing or missing capabilities lose ranking over time. Set a monthly reminder to audit all your directory and registry listings and ensure they reflect your tool's current state.
Write Content About Your Tool
Content marketing works for MCP tools just as it does for SaaS products. Write a blog post explaining the problem your tool solves, the approach you took, and the results it delivers. Publish on your own blog, dev.to, Hashnode, or Medium. Include code examples showing how to integrate your tool in common workflows.
Create tutorial content that shows your tool in action. A video walkthrough, a step-by-step blog post, or a Jupyter notebook that demonstrates your tool's capabilities can drive discovery from search engines and social media. Developers searching for "how to add weather data to my AI agent" should find your tutorial — and by extension, your tool.
Contribute to the MCP community. Answer questions on Stack Overflow, participate in MCP Discord channels, and comment on relevant GitHub issues. When someone asks "is there an MCP tool for X?" and your tool does X, a helpful answer with a link to your listing is the most effective marketing you can do. Community goodwill translates directly into discovery and adoption.
Leverage Cross-Promotion
Partner with complementary tool builders. If you built a geocoding tool, reach out to the weather tool builder and propose cross-promotion: each of you mentions the other in your listing and README. Agents that use geocoding often need weather data (and vice versa), so cross-promotion targets exactly the right audience.
Create tool bundles or workflow templates that combine multiple tools. A "complete data enrichment workflow" that chains your tool with 2-3 others demonstrates value and introduces each tool to the other tools' consumers. The SettleGrid marketplace supports workflow templates that link to all participating tools.
Track which channels drive the most discovery traffic. The SettleGrid dashboard shows referral sources for your listing: direct, marketplace search, category page, Discovery API, external link, and badge click. Double down on channels that work and sunset efforts that do not. Most tools find that 80% of their discovery comes from 2-3 channels — optimize those and ignore the rest.
Ready to get started?
Scaffold a complete MCP server with billing pre-wired in under 5 minutes.
Start Building — Free