Skip to content
Weavz
Menu
Octolens

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.

38 tools
13 triggers
Use withChatGPTClaudeClaude CodeCursorCodexMCP clientsSetup guide

Get started with Octolens

  1. Add Octolens to your Weavz workspace and connect the account you want to use.
  2. Review the available tools below and enable the actions your task needs. Check the account permissions before allowing changes.
  3. Connect a compatible AI client to your workspace, or use the actions API from your application.

Tools

Name

Generate Filter

generate_filter

Convert a natural-language query into an Octolens filter object for mentions or feeds.

Get Analytics Volume

get_analytics_volume

Count mentions per day or hour over a filter window.

Get Analytics Keywords

get_analytics_keywords

Get per-keyword mention counts for a filter window.

Get Analytics Sentiment

get_analytics_sentiment

Get sentiment distribution for matching mentions.

Get Analytics Sources

get_analytics_sources

Get source/platform breakdown for matching mentions.

Submit Relevance Feedback

submit_feedback

Submit thumbs-up or thumbs-down relevance feedback for a mention.

Remove Relevance Feedback

remove_feedback

Remove an existing feedback record by sourceId and timestamp.

List Feeds

list_feeds

List all Octolens feeds and their notification destinations.

Get Feed

get_feed

Fetch one feed by ID.

Create Feed

create_feed

Create a saved Octolens feed with optional filters and destinations.

Update Feed

update_feed

Update a feed name, icon, filters, default flag, or destinations. Omit destinations to leave them unchanged.

Delete Feed

delete_feed

Delete an Octolens feed.

Get Global Filters

get_global_filters

Get org-wide negative keywords, authors, subreddits, positive subreddits, and repos.

Update Global Filters

update_global_filters

Replace any Octolens org-wide filter list. Pass empty strings or arrays to clear a list.

List Tags

list_tags

List filterable AI-assigned tag names for mention filters.

Search Slack Channels

search_slack_channels

Search Slack channels available for Octolens feed destinations.

List Keywords

list_keywords

List all monitored Octolens keywords.

Create Keyword

create_keyword

Start monitoring a new Octolens keyword.

Update Keyword

update_keyword

Update an Octolens keyword configuration.

Delete Keyword

delete_keyword

Stop monitoring and remove a keyword.

Toggle Keyword Pause

toggle_keyword_pause

Toggle whether an Octolens keyword is actively collecting mentions.

List Keyword Suggestions

list_keyword_suggestions

List AI-generated keyword improvement suggestions.

Accept Keyword Suggestion

accept_keyword_suggestion

Apply an AI-generated keyword suggestion, optionally with a modified value.

Reject Keyword Suggestions

reject_keyword_suggestions

Reject one suggestion or all pending suggestions for a keyword.

List Organization Members

list_org_members

List all members of the Octolens organization.

Invite Organization Member

invite_org_member

Invite a teammate to the Octolens organization.

Remove Organization Member

remove_org_member

Remove a member from the Octolens organization.

List Mentions

list_mentions

List mentions with feed/view, simple, advanced, and convenience filters.

Export Mentions

export_mentions

Export up to 50,000 mentions as JSON or CSV.

Get Mention

get_mention

Fetch one mention by its stable platform-native sourceId.

List Mentions By Author

list_mentions_by_author

List mentions authored by one person on a supported platform.

Update Mention

update_mention

Toggle engaged state, update AI relevance, or update sentiment for a mention.

Get Organization

get_org

Get the authenticated Octolens workspace.

Get Usage Stats

get_org_usage

Get mention and keyword counts for the current billing cycle.

Update Organization

update_org

Update editable workspace settings such as name and enabled platforms.

Get Company Profile

get_company

Get the monitored company profile for the authenticated organization.

Update Company Profile

update_company

Update monitored company fields, social handles, competitors, and AI guidelines.

Custom API Call

custom_api_call

Make a bounded Octolens v2 API call against supported Octolens resource prefixes.

Triggers

Name

New Mention

new_mention

Triggers when a new Octolens mention appears after the initial baseline.

New Negative Mention

new_negative_mention

Triggers when a new negative Octolens mention appears.

New High Relevance Mention

new_high_relevance_mention

Triggers when a new high-relevance Octolens mention appears.

New Buy Intent Mention

new_buy_intent_mention

Triggers when a new mention carries Octolens AI buy-intent tagging.

New Feed Mention

new_feed_mention

Triggers when a new mention appears for a specific Octolens feed/view.

New Author Mention

new_author_mention

Triggers when an author has a new mention on a supported platform.

Mention Updated

mention_updated

Triggers when a previously seen Octolens mention changes relevance, sentiment, tags, or engagement state.

New Keyword Suggestion

new_keyword_suggestion

Triggers when Octolens creates a new AI keyword suggestion.

Usage Threshold Reached

usage_threshold_reached

Triggers when Octolens usage crosses the configured mention quota percentage.

Webhook Received

webhook_received

Receive parsed Octolens webhook payloads from feed destinations. Octolens currently does not sign webhook payloads.

Webhook Mention Created

webhook_mention_created

Receive Octolens feed-destination webhook events where action is mention_created.

Webhook Negative Mention

webhook_negative_mention

Receive Octolens mention_created webhooks with negative sentiment.

Webhook Buy Intent Mention

webhook_buy_intent_mention

Receive Octolens mention_created webhooks with Buy Intent tags.

Quick Start

TypeScript
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.