TweetBinder MCP Server for Claude

The TweetBinder MCP Server is a server based on the Model Context Protocol (MCP) that enables Claude and other MCP-compatible clients to interact with your TweetBinder by Audiense account. This integration allows users to access Twitter analytics, create reports, and retrieve detailed social media insights directly from Claude.

Features

• Access TweetBinder analytics directly from Claude.
• Analyze hashtags, users, and conversations on Twitter/X.
• Retrieve engagement metrics, sentiment analysis, and more.
• Create Twitter reports with custom search queries.
• Check report generation status.
• Retrieve detailed report statistics.
• Get account balance and quota information.
• Count tweets matching specific queries.
• List and manage your TweetBinder reports.
• Access tweet content and user information from reports.

Installation

Installing via Smithery

To install the TweetBinder MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AudienseCo/mcp-tweetbinder --client claude

Manual Configuration

Prerequisites

• Node.js (v18 or higher)
• Claude Desktop App

• TweetBinder by Audiense account with API credentials

• Clone this repository.

• Install dependencies:

shell npm install

1. Build the project:

shell npm run build

1. Set your TweetBinder API Bearer Token in your environment:

shell export TWEETBINDER_API_TOKEN='your-bearer-token-here'

Usage with Claude Desktop

1. Edit your Claude Desktop configuration file:

2. MacOS:

   shell code ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. Windows:

   shell code %AppData%\Claude\claude_desktop_config.json

4. Add this configuration:

json "mcpServers": { "tweetbinder": { "command": "node", "args": ["/absolute/path/to/build/index.js"], "env": { "TWEETBINDER_API_TOKEN": "your-bearer-token-here" } } }

1. Restart Claude Desktop.

Available Tools

create-twitter-report

Creates a new report that analyzes Twitter/X data based on a search query.

• Parameters:
• query (string): The search query for Twitter data.
• limit (number, optional): Maximum number of tweets to retrieve.
• startDate (number, optional): Start date as Unix timestamp.
• endDate (number, optional): End date as Unix timestamp.

• reportType (enum, optional): Type of report to create.

• Response: Report ID and status information.

create-twitter-count

Creates a new report that counts tweets matching a search query.

• Parameters:
• query (string): The search query for Twitter data.

• reportType (enum, optional): Type of report to create.

• Response: Raw JSON response containing report status and ID.

list-reports

Retrieves a list of all your TweetBinder reports with sorting capabilities.

• Parameters:

• order (string, optional): Sorting parameter.

• Response: Array of reports with details.

get-report-content

Retrieves the actual tweets or users from a generated report.

• Parameters:
• reportId (string): The ID of the report.
• contentType (enum): Type of content to retrieve.
• page (number, optional): Page number for pagination.
• perPage (number, optional): Number of items per page.
• sortBy (string, optional): Field to sort by.
• sortDirection (enum, optional): Sort direction.

• filter (string, optional): JSON string with filter criteria.

• Response: Array of tweet or user objects with pagination information.

get-report-status

Checks the current status of a TweetBinder report.

• Parameters:

• reportId (string): The ID of the report.

• Response: Current status of the report.

get-report-stats

Retrieves comprehensive statistics and analytics for a TweetBinder report.

• Parameters:

• reportId (string): The ID of the report.

• Response: Formatted summary of the report statistics.

get-account-balances

Retrieves information about your account's credit balance, usage, and remaining quota.

• Parameters: None
• Response: Raw JSON response containing account balance and quota information.

Troubleshooting

Tools Not Appearing in Claude

1. Check Claude Desktop logs:

shell tail -f ~/Library/Logs/Claude/mcp*.log

1. Verify environment variables are set correctly.
2. Ensure the absolute path to index.js is correct.

Authentication Issues

• Double-check credentials.
• Ensure the refresh token is still valid.
• Verify that the required API scopes are enabled and that you have enough credits.

Viewing Logs

For MacOS/Linux:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

For Windows:

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

Security Considerations

• Keep API credentials secure – never expose them in public repositories.
• Use environment variables to manage sensitive data.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for more details.

About

TweetBinder MCP Server is a server based on the Model Context Protocol (MCP) that allows Claude and other MCP-compatible clients to interact with your TweetBinder by Audiense account.

www.tweetbinder.com