How to List Your AI Agent on Fushu

Why List Your Agent on Fushu?

Fushu is the largest directory of AI agents, MCP servers, frameworks, and developer tools, with 2,318+ listings and growing. Listing your agent gives you immediate access to a thriving ecosystem of developers and teams actively searching for AI solutions.

Here is what you get when you list:

• Discoverability — Your agent appears in search results across a directory of 2,318+ projects. Developers find you through keyword search, category browsing, and curated collections.
• Trust Score — Every listing gets an automated trust score (0–100) based on GitHub activity, documentation quality, community engagement, and maintenance signals. A high score builds credibility.
• Embeddable Badge — Add a dynamic trust score badge to your GitHub README that links back to your Fushu profile. It updates automatically as your score changes.
• API Exposure — Your agent is available via the Fushu API, making it discoverable by other agents and automated tooling.
• Community & Comparisons — Users can star, review, and compare your agent against alternatives, giving you feedback and visibility.

3 Ways to List Your Agent

Fushu offers three registration paths depending on how much detail you want to provide upfront:

1. Quick Registration Form — A single-page form. Fill in the essentials and submit in about 2 minutes.
2. Step-by-Step Wizard — A guided 5-step flow with live preview. Best for comprehensive listings.
3. API Submission — Programmatically register agents using the Fushu API and a fushu.json manifest file.

Option 1: Quick Registration (2 Minutes)

The quick registration form is the fastest way to list your agent. Head to /register and fill in these fields:

Field	Description	Required
Name	Your agent or project name (e.g., “CodeReview Bot”)	Yes
GitHub URL	Link to the source repository	Yes
Type	One of: agent, mcp-server, framework, tool, oss-repo	Yes
Tagline	A short, catchy description (under 80 characters)	Yes
Description	A longer explanation of what your agent does, who it is for, and key features	Recommended

Tip: A strong tagline makes all the difference. Compare “A tool for code” with “AI-powered code reviewer that catches bugs before your teammates do.”

Once submitted, your listing enters the community review queue and is typically published within 24 hours.

Option 2: Step-by-Step Wizard

The onboarding wizard walks you through 5 steps with a live preview of your listing as you build it:

Option 3: API Registration

For teams managing multiple agents or automating registration in CI/CD, use the Fushu API directly.

Validate Your Manifest

First, create a fushu.json manifest file in your repository root:

{
  "name": "my-agent",
  "type": "agent",
  "tagline": "AI-powered code reviewer",
  "description": "Automatically reviews pull requests...",
  "github": "https://github.com/yourorg/my-agent",
  "capabilities": ["code-review", "pr-analysis"],
  "protocols": ["MCP"],
  "language": "Python",
  "install": "pip install my-agent"
}

Then validate it against the Fushu schema using the API:

curl -X POST https://fushu.dev/api/v1/agents/validate \
  -H "Content-Type: application/json" \
  -d @fushu.json

The endpoint returns validation results with any errors or warnings, so you can fix issues before submitting. See the full API documentation for all available endpoints.

Add a Fushu Badge to Your README

Once your agent is listed, add a trust score badge to your GitHub README. The badge displays your current trust score and links to your Fushu profile:

Markdown

[![Fushu Trust Score](https://fushu.dev/badge/YOUR-AGENT-ID.svg)](https://fushu.dev/agent/YOUR-AGENT-ID)

HTML

<a href="https://fushu.dev/agent/YOUR-AGENT-ID">
  <img src="https://fushu.dev/badge/YOUR-AGENT-ID.svg" alt="Fushu Trust Score" />
</a>

Replace YOUR-AGENT-ID with your agent’s ID (visible in the URL of your agent profile page). You can find embed codes ready to copy at /badge/YOUR-AGENT-ID/embed.

The badge updates automatically. As your trust score improves (more stars, better docs, active maintenance), the badge reflects the change in real time.

Claim Your Agent

If your agent is already listed on Fushu (we auto-discover agents from GitHub trending, topics, and registries), you can claim ownership to manage the listing.

Visit the claims page, search for your agent, and verify ownership via your GitHub account. Once claimed, you can:

• Edit description, tagline, and capabilities
• Respond to community reviews
• Access analytics on views and searches
• Get the verified owner badge on your profile

Tips for a Great Listing

Listings with complete, well-written profiles get significantly more traffic and stars. Here is what sets top listings apart:

1. Write a compelling tagline — Your tagline appears in search results and directory cards. Make it specific and benefit-oriented. Avoid generic descriptions like “an AI tool”.
2. Provide a complete description — Explain what your agent does, what problem it solves, who it is for, and what makes it different. Include key features and use cases.
3. Link your GitHub repository — Listings with a valid GitHub URL get higher trust scores. Active repos with recent commits, open issues, and a README score even higher.
4. Tag capabilities accurately — Capabilities drive search and discovery. Use specific, relevant tags rather than broad ones.
5. Add install instructions — One-line install commands (e.g., npm install, pip install) make it easy for users to try your agent immediately.
6. Keep your listing updated — Fushu tracks maintenance signals. Agents with recent GitHub activity and updated descriptions rank higher in search and trending.