AI AGENT INTEGRATION
Query and update mentions from an AI assistant.
Social Line runs a Model Context Protocol server at /mcp, alongside the dashboard and REST API. Connect Claude, or any other MCP-compatible client, over OAuth or a scoped API key, and it can list tracked keywords, read mentions, trigger a keyword run, or set mention status and category, through the same service layer everything else in Social Line uses.
Mentions for “Example Co.”
SAMPLE DATA · FICTIONAL BRAND
HOW IT WORKS
The workflow, step by step.
Add Social Line as a connector
In Claude, add a custom connector pointed at the MCP URL, or generate a scoped API key from Settings and use it as a bearer token from any MCP client.
Authenticate once, scoped from there
OAuth connections and API keys each carry a read or read-and-write scope. Read-only exposes list and get tools; read-and-write adds create, update, and run.
The assistant calls tools directly
Listing keywords, reading mention status, or setting a category all happen as MCP tool calls, backed by the same keyword, mention, and settings services the dashboard calls.
WHAT'S INCLUDED
What makes this work.
Coverage across the account
Keywords, mentions, run history, categories, keyword groups, subscription details, and public dashboard settings are all reachable as MCP tools, not a limited subset.
OAuth 2.0 with per-connection revocation
Approve a connector once, then see it listed under Connected Apps in Settings and revoke it independently at any time, no shared password to rotate.
Scoped API keys as an alternative
For clients that don't support OAuth, generate a named API key with a read or read-and-write scope instead, and revoke it the same way.
Stateless, request-scoped sessions
Each MCP request is handled by a server instance scoped to that credential's user and permissions, with no session state kept between requests.
FAQ
Questions about ai agent integration
Does this replace the dashboard?
No. It's a second way to reach the same account data, useful when an AI assistant or script is doing the querying instead of a person clicking through the UI.
What can a write-scoped connection actually change?
It can create, update, or delete keywords and categories, and set a mention's status or category, the same actions available from the dashboard.
Can I limit an assistant to read-only access?
Yes. Create an API key or approve an OAuth connection with only the read scope, and every write tool is left unregistered for that connection.
The internet is talking.
Start listening.
First results land within about two minutes of setup, then each keyword runs on the schedule you pick, from every 5 minutes to daily.
Takes a minute to set up · Free for 14 days · No credit card