🤖 AI & Agent Connectivity

Sentor is built to be “AI-First”. We provide several standardized ways for AI agents, LLMs, and automation tools to discover and interact with our sentiment analysis capabilities natively.

📡 Discovery Standards

Sentor implements three major standards for AI discovery:

1. `llms.txt`

Located at the root: sentor.app/llms.txt

This is a human-readable but LLM-optimized summary of our API. If you are using an AI that can browse the web (like ChatGPT with Search or Claude), you can simply point it to this file to help it understand how to write code for Sentor.

2. MCP (Model Context Protocol)

Package: sentor-mcp on PyPI

Sentor ships a native MCP server that exposes sentiment analysis, clustering, and topic naming as tools your AI assistant can call directly. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible host — no custom code required, just one config block with your API key.

# Quickest way — no install needed
uvx sentor-mcp

[!TIP] For full setup instructions (Claude Desktop, Cursor, remote Docker), see the MCP Integration Guide.

3. OpenAPI Specification

Located at: https://sentor.app/.well-known/openapi.json

Our full API is documented using OpenAPI 3.1. This is the gold standard for:

GPT Actions: Create a Custom GPT and import this URL to give it sentiment analysis powers.
Gemini Extensions: Use this spec to integrate Sentor into Google AI workflows.
SDK Generation: Use tools like openapi-generator to create clients in any language.

🛠️ Integration Use-Cases

ChatGPT Custom GPTs

You can build a “Sentiment Analyst GPT” in minutes:

Go to GPT Editor -> Actions.
Select “Import from URL”.
Enter: https://sentor.app/.well-known/openapi.json.
Add your x-api-key in the Authentication settings (API Key -> Header).

Automated Agents (Python/Node)

When building agents with LangChain, AutoGPT, or CrewAI, providing the OpenAPI spec or the llms.txt content in the “System Prompt” significantly improves the agent’s ability to use Sentor without help.

🔒 Security for Agents

When sharing Sentor with an agent:

Always use the x-api-key header.
You can find your API key in the Sentor Dashboard.
Note: We currently offer one active API key per account.