API Documentation

Query the AgentSift capability registry programmatically. Perfect for building agent tooling, IDE extensions, or custom discovery interfaces.

●Interactive — try endpoints live below

Base URL

https://agentsift.com

All endpoints return JSON. Responses are cached for performance.

GET/api/badge/capability/:id

Get an embeddable SVG badge for a capability (shields.io style)

Query Parameters

idstringCapability ID (path param)

stylestringBadge style: flat (default), flat-square

scorestringShow trust score (default: true). Set to false for simple "listed" badge

Example

/api/badge/capability/filesystem-mcp?style=flat

Response

<!-- SVG badge showing trust score -->
![AgentSift 85% trust](https://agentsift.com/api/badge/capability/filesystem-mcp)

<!-- Usage in README.md -->
[![AgentSift](https://agentsift.com/api/badge/capability/YOUR-CAPABILITY-ID)](https://agentsift.com/capabilities/YOUR-CAPABILITY-ID)

GET/api/badge/:framework

Get an embeddable SVG badge showing capability count for a framework

Query Parameters

frameworkstringFramework: openclaw, mcp, langchain, crewai, composio, openai, near-ai

stylestringBadge style: flat (default), flat-square

Example

/api/badge/mcp?style=flat

Response

<!-- SVG badge showing framework capability count -->
![MCP 450 capabilities](https://agentsift.com/api/badge/mcp)

<!-- Supported frameworks: openclaw, mcp, langchain, crewai, composio, openai, near-ai -->

GET/api/capabilities

List and search capabilities

Query Parameters

qstringSearch query (searches name, description, intents, tags)

platformstringFilter by platform (openclaw, mcp, langchain)

categorystringFilter by category

minTrustnumberMinimum trust score (0-100)

limitnumberResults per page (default: 20, max: 100)

offsetnumberPagination offset (default: 0)

Example

/api/capabilities?q=weather&platform=mcp&limit=10

Response

{
  "data": [
    {
      "id": "weather-api",
      "name": "Weather API",
      "description": "Get weather forecasts and conditions",
      "intents": ["check weather", "get forecast"],
      "platforms": ["mcp"],
      "category": "data",
      "trustScore": 85,
      "url": "https://github.com/...",
      "tags": ["weather", "api"]
    }
  ],
  "meta": {
    "total": 1,
    "limit": 10,
    "offset": 0,
    "query": "weather",
    "filters": { "platform": "mcp" }
  }
}

GET/api/capabilities/:id

Get a single capability by ID

Query Parameters

idstringCapability ID

Example

/api/capabilities/weather-api

Response

{
  "data": {
    "id": "weather-api",
    "name": "Weather API",
    "description": "Get weather forecasts and conditions",
    "intents": ["check weather", "get forecast"],
    "platforms": ["mcp"],
    "category": "data",
    "trustScore": 85,
    "url": "https://github.com/...",
    "tags": ["weather", "api"],
    "source": "MCP Awesome Servers",
    "riskLevel": "safe",
    "permissions": ["network:http"]
  }
}

GET/api/meta

Get metadata about available platforms, categories, and stats

Example

/api/meta

Response

{
  "stats": {
    "totalCapabilities": 847,
    "averageTrustScore": 62
  },
  "platforms": ["langchain", "mcp", "openclaw"],
  "categories": ["ai-ml", "automation", "data", ...],
  "sources": ["LangChain Tools", "MCP Awesome Servers", ...]
}

POST/api/submit

Submit a new capability for review

Body Parameters

namestringCapability name (required)

descriptionstringWhat it does (required)

urlstringRepository or docs URL (required)

platformstringPlatform type (required)

categorystringCategory (required)

tagsstringComma-separated tags (optional)

emailstringContact email (optional)

Example

POST /api/submit

Response

{
  "success": true,
  "id": "my-capability-a1b2c3"
}

Usage Notes

• Rate Limits: None currently, but please be respectful
• Caching: Responses cached for 60s (list) / 5min (single)
• CORS: Enabled for all origins
• Authentication: None required (public API)

Questions or feature requests? Open an issue