MCP SERVER
Give your AI agent direct access to your mentions.
Social Line exposes a Model Context Protocol (MCP) server over Streamable HTTP. Connect Claude or any other MCP-compatible agent and it can list keywords, triage mentions, and check account settings using the same service layer that backs the dashboard and REST API - nothing separate to keep in sync.
CONNECTING
Two ways to authenticate, one endpoint either way.
OAuth 2.0
In Claude, go to Settings > Connectors > Add custom connector and paste in your MCP endpoint, shown on your dashboard's Settings page. Approve access when prompted, and the connection is ready to revoke at any time.
Scoped API keys
Generate a key from the dashboard's Settings page and send it as a bearer token instead. Each key is scoped to read-only or read-and-write, named after the assistant using it, and revoked independently of any others.
AGENT ACCESS
Plug and play with the AI agent you already run.
Social Line runs a Model Context Protocol server at /mcp. Point Claude or any other MCP-compatible AI agent at it over OAuth or a scoped API key and it's live - no separate integration to build or keep in sync, since it calls the same service layer that backs the dashboard and REST API.
Read-only keys expose the list and get tools. Read-and-write keys add create and update. Each request is handled statelessly by a server instance scoped to that credential's user and scopes.
“What are people saying about us on Reddit this week?”
list_keywords
→ 3 keywords · 1,240 mentions, mostly positive
“Mark that pricing complaint as resolved.”
set_mention_status
→ Marked as resolved
“Tag that Northwind comparison as competitor feedback.”
set_mention_category
→ Category set: Competitor feedback
TOOL REFERENCE
Every tool the MCP server exposes
Tools marked write are only available to read-and-write credentials.
Keywords
- list_keywords
- List every tracked keyword, with mention counts.
- list_keyword_runs
- List stored search results for one keyword.
- create_keywordwrite
- Start tracking a keyword on chosen platforms, with optional filters. It runs every 12 hours by default, first results in about two minutes.
- update_keywordwrite
- Change a keyword's group, platforms, filters, or schedule, or pause and resume it.
- delete_keywordwrite
- Stop tracking a keyword and delete its stored mentions.
Keyword groups
- list_keyword_groups
- List keyword groups in display order.
- create_keyword_groupwrite
- Create a group to organize keywords under.
- delete_keyword_groupwrite
- Delete an empty keyword group.
Mentions
- list_runs
- List search results (the mentions themselves), optionally filtered by keyword or platform.
- list_mention_statuses
- List each mention's triage status.
- list_mention_categories
- List which category each mention is tagged with.
- set_mention_statuswrite
- Mark a mention open, follow up, done, or irrelevant.
- set_mention_categorywrite
- Tag a mention with a category, or clear it.
Categories
- list_categories
- List mention categories in display order.
- create_categorywrite
- Add a category with an icon, name, and description.
- update_categorywrite
- Edit a category's icon, name, or description.
- delete_categorywrite
- Delete a category and clear it from its mentions.
Account & settings
- get_subscription
- Get the current plan, billing status, and plan limits.
- get_public_dashboard_settings
- Get public dashboard sharing settings and URL.
- set_public_dashboard_settingswrite
- Turn the public dashboard on or off, or edit its description and website URL.
FAQ
Questions about MCP access
What is an MCP server for social listening?
It's a Model Context Protocol endpoint that lets an AI agent read and act on social listening data directly. Instead of exporting mentions and pasting them into a chat, the agent calls tools like list_runs or set_mention_status against your live Social Line account.
Which AI assistants can connect?
Any client that supports remote MCP servers over Streamable HTTP. Claude connects with OAuth as a custom connector; clients without OAuth support can use a scoped API key as a bearer token.
Can an agent change my account?
Only with read-and-write access. A read-only API key exposes just the list and get tools. Write tools (create, update, delete, and setting a mention's status or category) are only available to read-and-write credentials, and any connection can be revoked from Settings.
Which plans include MCP access?
Every plan, starting at $15/month billed annually. Plan limits on keywords and mentions apply the same way they do in the dashboard.
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