TrendsAGI MCP server

TrendsAGI Official Python Client

About

Real-time trend intelligence for your code and your AI agents.

trendsagi gives Python apps and autonomous agents structured access to what is trending right now on social platforms: measured volume and growth, AI insights explaining why a topic is moving, evidence-backed recommendations, crisis alerts, and watchlists. Paid media and growth teams use it to target what is rising, time spend to the trend curve, and brief creative on measured demand. It ships with:

• A typed REST client (TrendsAGIClient).
• Agent tools (TrendsAGITools) for OpenAI function calling, Anthropic tool use, and LangChain.
• An MCP server (trendsagi mcp) for Claude Desktop, Claude Code, Cursor, VS Code, and any other Model Context Protocol client.
• A plugin for Grok, Cursor and Claude (plugins/trendsagi) backed by the hosted MCP server.
• BYOC executors that preview or apply Google/Meta/TikTok/LinkedIn ad changes from your own infrastructure.

Use TrendsAGI in Grok, ChatGPT, Claude or Cursor (no install)

TrendsAGI runs a hosted MCP server with OAuth sign-in:

https://api.trendsagi.com/mcp

Add that URL as a remote MCP server, custom connector or plugin in your assistant, sign in to TrendsAGI, and approve the connection. Then ask things like "What is accelerating fastest in Technology this week, and who should I target with it?" or "Is this trend still rising, or should I pull spend?"

• Grok: install the TrendsAGI plugin, or add the URL as a remote MCP server.
• Claude Code: claude mcp add --transport http trendsagi https://api.trendsagi.com/mcp, or /plugin marketplace add TrendsAGI/TrendsAGI then /plugin install trendsagi@trendsagi.
• Cursor: { "mcpServers": { "trendsagi": { "url": "https://api.trendsagi.com/mcp" } } }.
• ChatGPT and others: add the URL as a custom connector.

The hosted tools are read-only and count toward your plan's API limits. Each connection gets its own key, listed as "AI connector: " under Profile > API Keys; delete it to disconnect. Clients without OAuth can send an existing API key as Authorization: Bearer . Setup guide: trendsagi.com/mcp.

Plan Notes (API Access)

• Developer plan includes:
• 1 API integration connection
• 100 API calls/day included
• Overage billing above included daily usage
• Advantage/Scale unlock higher daily API limits, more keys, and expanded team workflows.

Resources

• Website: https://trendsagi.com
• API Docs: https://trendsagi.com/api-docs
• Endpoint Reference: https://trendsagi.com/api-docs#endpoints
• BYOC Integrations Guide (repo): INTEGRATIONS_BYOC.md

Installation

pip install trendsagi            # client + agent tools
pip install "trendsagi[mcp]"     # adds the MCP server (Python 3.10+)

Create an API key in your TrendsAGI profile and export it:

export TRENDSAGI_API_KEY="your_api_key"

Quick Start

import os
from trendsagi import TrendsAGIClient

client = TrendsAGIClient(api_key=os.environ["TRENDSAGI_API_KEY"])

# Fastest-moving Technology topics right now
trends = client.get_trends(category="Technology", sort_by="velocity", limit=5)
for trend in trends.trends:
    print(trend.id, trend.name, trend.volume)

# Why is the top one moving?
insight = client.get_ai_insights(trends.trends[0].id)
if insight:
    print(insight.sentiment_summary, insight.key_themes)

Shortened. The full README is on GitHub.