Octolens MCP integration
Query Octolens social listening mentions, manage keywords and feeds, run analytics, submit feedback, and receive mention webhooks.
Sign in, add Octolens in Apps, then choose the account your AI can use.
Get started with Octolens
- Add Octolens to your Weavz workspace and connect the account you want to use.
- Review the available tools below and enable the actions your task needs. Check the account permissions before allowing changes.
- Connect a compatible AI client to your workspace, or use the actions API from your application.
Tools
| Name | Description |
|---|---|
Generate Filter generate_filterConvert a natural-language query into an Octolens filter object for mentions or feeds. | Convert a natural-language query into an Octolens filter object for mentions or feeds. |
Get Analytics Volume get_analytics_volumeCount mentions per day or hour over a filter window. | Count mentions per day or hour over a filter window. |
Get Analytics Keywords get_analytics_keywordsGet per-keyword mention counts for a filter window. | Get per-keyword mention counts for a filter window. |
Get Analytics Sentiment get_analytics_sentimentGet sentiment distribution for matching mentions. | Get sentiment distribution for matching mentions. |
Get Analytics Sources get_analytics_sourcesGet source/platform breakdown for matching mentions. | Get source/platform breakdown for matching mentions. |
Submit Relevance Feedback submit_feedbackSubmit thumbs-up or thumbs-down relevance feedback for a mention. | Submit thumbs-up or thumbs-down relevance feedback for a mention. |
Remove Relevance Feedback remove_feedbackRemove an existing feedback record by sourceId and timestamp. | Remove an existing feedback record by sourceId and timestamp. |
List Feeds list_feedsList all Octolens feeds and their notification destinations. | List all Octolens feeds and their notification destinations. |
Get Feed get_feedFetch one feed by ID. | Fetch one feed by ID. |
Create Feed create_feedCreate a saved Octolens feed with optional filters and destinations. | Create a saved Octolens feed with optional filters and destinations. |
Update Feed update_feedUpdate a feed name, icon, filters, default flag, or destinations. Omit destinations to leave them unchanged. | Update a feed name, icon, filters, default flag, or destinations. Omit destinations to leave them unchanged. |
Delete Feed delete_feedDelete an Octolens feed. | Delete an Octolens feed. |
Get Global Filters get_global_filtersGet org-wide negative keywords, authors, subreddits, positive subreddits, and repos. | Get org-wide negative keywords, authors, subreddits, positive subreddits, and repos. |
Update Global Filters update_global_filtersReplace any Octolens org-wide filter list. Pass empty strings or arrays to clear a list. | Replace any Octolens org-wide filter list. Pass empty strings or arrays to clear a list. |
List Tags list_tagsList filterable AI-assigned tag names for mention filters. | List filterable AI-assigned tag names for mention filters. |
Search Slack Channels search_slack_channelsSearch Slack channels available for Octolens feed destinations. | Search Slack channels available for Octolens feed destinations. |
List Keywords list_keywordsList all monitored Octolens keywords. | List all monitored Octolens keywords. |
Create Keyword create_keywordStart monitoring a new Octolens keyword. | Start monitoring a new Octolens keyword. |
Update Keyword update_keywordUpdate an Octolens keyword configuration. | Update an Octolens keyword configuration. |
Delete Keyword delete_keywordStop monitoring and remove a keyword. | Stop monitoring and remove a keyword. |
Toggle Keyword Pause toggle_keyword_pauseToggle whether an Octolens keyword is actively collecting mentions. | Toggle whether an Octolens keyword is actively collecting mentions. |
List Keyword Suggestions list_keyword_suggestionsList AI-generated keyword improvement suggestions. | List AI-generated keyword improvement suggestions. |
Accept Keyword Suggestion accept_keyword_suggestionApply an AI-generated keyword suggestion, optionally with a modified value. | Apply an AI-generated keyword suggestion, optionally with a modified value. |
Reject Keyword Suggestions reject_keyword_suggestionsReject one suggestion or all pending suggestions for a keyword. | Reject one suggestion or all pending suggestions for a keyword. |
List Organization Members list_org_membersList all members of the Octolens organization. | List all members of the Octolens organization. |
Invite Organization Member invite_org_memberInvite a teammate to the Octolens organization. | Invite a teammate to the Octolens organization. |
Remove Organization Member remove_org_memberRemove a member from the Octolens organization. | Remove a member from the Octolens organization. |
List Mentions list_mentionsList mentions with feed/view, simple, advanced, and convenience filters. | List mentions with feed/view, simple, advanced, and convenience filters. |
Export Mentions export_mentionsExport up to 50,000 mentions as JSON or CSV. | Export up to 50,000 mentions as JSON or CSV. |
Get Mention get_mentionFetch one mention by its stable platform-native sourceId. | Fetch one mention by its stable platform-native sourceId. |
List Mentions By Author list_mentions_by_authorList mentions authored by one person on a supported platform. | List mentions authored by one person on a supported platform. |
Update Mention update_mentionToggle engaged state, update AI relevance, or update sentiment for a mention. | Toggle engaged state, update AI relevance, or update sentiment for a mention. |
Get Organization get_orgGet the authenticated Octolens workspace. | Get the authenticated Octolens workspace. |
Get Usage Stats get_org_usageGet mention and keyword counts for the current billing cycle. | Get mention and keyword counts for the current billing cycle. |
Update Organization update_orgUpdate editable workspace settings such as name and enabled platforms. | Update editable workspace settings such as name and enabled platforms. |
Get Company Profile get_companyGet the monitored company profile for the authenticated organization. | Get the monitored company profile for the authenticated organization. |
Update Company Profile update_companyUpdate monitored company fields, social handles, competitors, and AI guidelines. | Update monitored company fields, social handles, competitors, and AI guidelines. |
Custom API Call custom_api_callMake a bounded Octolens v2 API call against supported Octolens resource prefixes. | Make a bounded Octolens v2 API call against supported Octolens resource prefixes. |
Triggers
| Name | Description |
|---|---|
New Mention new_mentionTriggers when a new Octolens mention appears after the initial baseline. | Triggers when a new Octolens mention appears after the initial baseline. |
New Negative Mention new_negative_mentionTriggers when a new negative Octolens mention appears. | Triggers when a new negative Octolens mention appears. |
New High Relevance Mention new_high_relevance_mentionTriggers when a new high-relevance Octolens mention appears. | Triggers when a new high-relevance Octolens mention appears. |
New Buy Intent Mention new_buy_intent_mentionTriggers when a new mention carries Octolens AI buy-intent tagging. | Triggers when a new mention carries Octolens AI buy-intent tagging. |
New Feed Mention new_feed_mentionTriggers when a new mention appears for a specific Octolens feed/view. | Triggers when a new mention appears for a specific Octolens feed/view. |
New Author Mention new_author_mentionTriggers when an author has a new mention on a supported platform. | Triggers when an author has a new mention on a supported platform. |
Mention Updated mention_updatedTriggers when a previously seen Octolens mention changes relevance, sentiment, tags, or engagement state. | Triggers when a previously seen Octolens mention changes relevance, sentiment, tags, or engagement state. |
New Keyword Suggestion new_keyword_suggestionTriggers when Octolens creates a new AI keyword suggestion. | Triggers when Octolens creates a new AI keyword suggestion. |
Usage Threshold Reached usage_threshold_reachedTriggers when Octolens usage crosses the configured mention quota percentage. | Triggers when Octolens usage crosses the configured mention quota percentage. |
Webhook Received webhook_receivedReceive parsed Octolens webhook payloads from feed destinations. Octolens currently does not sign webhook payloads. | Receive parsed Octolens webhook payloads from feed destinations. Octolens currently does not sign webhook payloads. |
Webhook Mention Created webhook_mention_createdReceive Octolens feed-destination webhook events where action is mention_created. | Receive Octolens feed-destination webhook events where action is mention_created. |
Webhook Negative Mention webhook_negative_mentionReceive Octolens mention_created webhooks with negative sentiment. | Receive Octolens mention_created webhooks with negative sentiment. |
Webhook Buy Intent Mention webhook_buy_intent_mentionReceive Octolens mention_created webhooks with Buy Intent tags. | Receive Octolens mention_created webhooks with Buy Intent tags. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('octolens', 'generate_filter', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'octolens',
input: { /* ... */ },
})Related Integrations
Explore integrations in other categories
Frequently Asked Questions
Is there a Octolens MCP server through Weavz?
Yes. Add the Octolens integration to a Weavz workspace, enable the actions you need and connect any required account. Weavz provides the workspace MCP endpoint in Tool Mode or Code Mode. The catalog currently lists 38 Octolens actions.
What can an AI agent do with Octolens?
Available actions include Generate Filter, Get Analytics Volume, Get Analytics Keywords, Get Analytics Sentiment, Get Analytics Sources, and more. Your workspace exposes only the actions you enable. The agent also needs the intended account access and any required input values.
How do I connect Octolens to Claude or ChatGPT?
Use a compatible remote MCP client, add the Weavz connector and choose a workspace. Add Octolens, connect the required account and review the enabled actions. Client availability and account requirements vary; adding the connector does not authorize every app automatically.
Can I use Octolens through an API or SDK?
Yes, supported actions can run through the Weavz REST API, TypeScript SDK or Python SDK. Configure a workspace and the required connections, use scoped access, and pass the intended end-user context when acting for a customer.
What authentication does Octolens require?
The catalog lists an API key for Octolens. Use Hosted Connect to authorize the intended account. Required permissions, provider app access and available connection methods depend on the integration.
How do I review sensitive Octolens actions?
Limit enabled actions, scope credentials to the intended user and configure Human Gates for the operations that need review. A matching policy can pause a send, record change or other sensitive action for an approver before execution.
What limits or costs apply to Octolens?
Weavz plan limits apply to the actions and resources you use. The external provider may also require an account, a paid plan, API credits or specific permissions, and may enforce its own rate limits. Check current Weavz pricing and the provider’s terms before rollout.
What Octolens triggers are available?
The catalog lists 13 triggers, including New Mention, New Negative Mention, New High Relevance Mention, New Buy Intent Mention, New Feed Mention, and more. Configure the trigger and your event handler before using incoming events to start work.
Connect Octolens in minutes
Get 20,000 free action executions every month. No credit card required.