Enriched Agents Directory
1 creditGET /api/premium/agents/directoryThe premium agents directory takes the static AI agents catalog and joins it with live signals: provider status, recent news mentions for that provider, agent traffic attribution from our bot signature tracking, and flagship pricing from /api/models. Each entry gets a derived 0-100 trending score that blends recency-weighted news count, agent traffic, and live status.
When to use this endpoint
When your agent needs a ranked, filtered shortlist of AI agents/tools rather than the raw catalog. Server-side filter and sort means agents pull a tight list in one call instead of stitching free endpoints.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| category | query | string | Filter to one category (coding, research, general, creative, frameworks) |
| status | query | string | operational, degraded, down, unknown |
| open_source | query | boolean | true for OSS-only, false for closed-only |
| sort | query | string | trending, alphabetical, status, price_low, price_high, news_count (default trending) |
| limit | query | integer | Max records (1-100, default 50) |
* required
Example response
{
"ok": true,
"total": 18, "returned": 5,
"agents": [
{
"id": "claude-code", "name": "Claude Code", "provider": "Anthropic",
"live_status": "operational", "recent_news_count": 7,
"agent_traffic_24h": 124, "trending_score": 86
}
]
}Code samples
Python SDK
from tensorfeed import TensorFeed
tf = TensorFeed(token="tf_live_...")
dir = tf.premium_agents_directory(category="coding", sort="trending", limit=5)TypeScript SDK
import { TensorFeed } from 'tensorfeed';
const tf = new TensorFeed({ token: 'tf_live_...' });
const d = await tf.premiumAgentsDirectory({ category: 'coding', sort: 'trending' });MCP tool
Available via the TensorFeed MCP server as premium_agents_directory. Add npx -y @tensorfeed/mcp-server to your Claude Desktop or Claude Code MCP config.
FAQ
How is the trending_score calculated?
60% recent news count (capped at 20 articles), 30% agent traffic (capped at 30 hits), 10% live status boost (operational +10, degraded +4, down 0, unknown +6). Range [0, 100].