Documentation

Everything you need to integrate AgentSifted into your workflow — APIs, badges, MCP tools, and more.

Quality Score API Trust Badges MCP Server

Quality Score API

Query trust scores programmatically. Use it in CI/CD pipelines, dashboards, or your own tools to evaluate agent quality before deployment.

Endpoints

GET /api/score?agent=<agentId>

Get trust score by agent ID

GET /api/score?name=<agentName>

Search and get score by name

Example

curl https://agentsifted.com/api/score?name=Claude+Code

# Response
{
  "name": "Claude Code",
  "trustScore": 910,
  "trustTier": "sovereign",
  "scores": {
    "security":     { "score": 92, "weight": "30%" },
    "reliability":  { "score": 88, "weight": "25%" },
    "transparency": { "score": 90, "weight": "25%" },
    "community":    { "score": 85, "weight": "20%" }
  },
  "github": { "stars": 25000, "forks": 1200, ... },
  "npm": { "weeklyDownloads": 150000 }
}

Authentication & Rate Limits

The API uses a credit-based pricing model. 1 API request = 1 credit. New accounts start with 100 free credits.

Tier	Price	Limits	Auth
Anonymous	Free	20 requests/day (no credits needed)	None
Starter	Free (100 credits)	1 credit per request	`Bearer <api_key>`
Pay-as-you-go	$1 = 100 credits	1 credit per request	`Bearer <api_key>`
Enterprise	Custom	Unlimited + SLA	API key + SLA

Credit Packages

500 credits

$10

1,000 credits

$25

2,500 credits

$50

5,000 credits

Getting started: Create an account to get 100 free credits. Generate an API key from your Dashboard, then buy more credits when you need them. No subscription required.

Enterprise? Contact hello@agentsifted.com for unlimited requests, SLA guarantees, and dedicated support.

Response Headers

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 2026-03-10T00:00:00.000Z

Embeddable Trust Badges

Add a trust score badge to your GitHub README, documentation, or website. Badges are SVG images that update automatically as scores change.

Badge URL

https://agentsifted.com/api/badge/<agentId>

Styles

?style=flat — Rounded corners (default)

?style=flat-square — Square corners

Usage in Markdown

<!-- In your README.md -->
[![AgentSifted Trust Score](https://agentsifted.com/api/badge/YOUR_AGENT_ID)](https://agentsifted.com/directory/YOUR_AGENT_ID)

Usage in HTML

<a href="https://agentsifted.com/directory/YOUR_AGENT_ID">
  <img src="https://agentsifted.com/api/badge/YOUR_AGENT_ID"
       alt="AgentSifted Trust Score" />
</a>

Tier Colors

Sovereign (900+)

Trusted (750-899)

Established (500-749)

Emerging (<500)

MCP Server for Agent Discovery

Use AgentSifted directly from Claude Code, Cursor, or any MCP-compatible AI tool. Search agents, check trust scores, and compare options without leaving your editor.

Installation

git clone https://github.com/razroo/agent-sifted-frontend.git
cd agent-sifted-frontend/mcp-server
npm install

Claude Code Setup

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "agentsifted": {
      "command": "node",
      "args": ["/path/to/mcp-server/index.mjs"]
    }
  }
}

Cursor Setup

Add to your MCP configuration:

{
  "mcpServers": {
    "agentsifted": {
      "command": "node",
      "args": ["/path/to/mcp-server/index.mjs"],
      "env": {
        "AGENTSIFTED_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

search_agents

Search the AgentSifted directory by name, keyword, or category.

// Input
{ "query": "database", "category": "MCP Server" }

// Returns list of matching agents with scores

get_agent_score

Get detailed trust score breakdown for a specific agent.

// Input
{ "agent": "Claude Code" }

// Returns full score breakdown + GitHub/npm stats

compare_agents

Compare trust scores of two or more agents side by side.

// Input
{ "agents": ["Claude Code", "Cursor", "Copilot"] }

// Returns formatted comparison table

Environment Variables

Variable	Default	Description
`AGENTSIFTED_URL`	https://agentsifted.com	Base URL for the Score API
`AGENTSIFTED_API_KEY`	—	API key for higher rate limits
`GRAPHQL_URL`	AppSync endpoint	Direct GraphQL endpoint

For Publishers

If you maintain an MCP server or AI agent listed on AgentSifted, you can claim your listing, manage it, and access publisher-only features.

Claim Your Listing

Find your agent in the directory, click "Claim this Agent" on the detail page, and submit a verification request. We review claims within 48 hours.

Publisher Dashboard

Once verified, manage your listings from the Dashboard. Update descriptions, manage versions, and generate API keys.

API Keys

Generate API keys from the Dashboard to access the Quality Score API with higher rate limits (100 req/day). Keys use the rzr_ prefix format.

Featured Listings

Boost your visibility with a featured placement at the top of the directory. Featured listings get a "Sponsored" badge and premium card layout. Contact hello@agentsifted.com for details.

SEO & Integrations

Sitemap

A full XML sitemap is available at /sitemap.xml and includes all agent detail pages with last-modified dates.

Structured Data

Every agent detail page includes JSON-LD structured data (SoftwareApplication schema) and Open Graph tags for rich previews when shared on social media or indexed by search engines.