# mcp-tweetbinder

> MCP Server

This repository provides a Model Context Protocol (MCP) server, enabling Claude and other AI models to access and analyze Twitter/X data through the TweetBinder by Audiense API, offering insights like

## Overview

- **Category:** Communication
- **Language:** TypeScript
- **Stars:** 3
- **Forks:** 0
- **Owner:** AudienseCo
- **GitHub:** https://github.com/AudienseCo/mcp-tweetbinder
- **Homepage:** https://www.tweetbinder.com
- **Created:** 2025-03-19T16:30:24+00:00
- **Updated:** 2025-03-20T21:51:49+00:00
- **Source:** https://model-context-protocol.com/servers/tweetbinder-mcp-server-twitter-analysis

## Setup

## Setup

### Installing via Smithery
To install mcp-tweetbinder for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@AudienseCo/mcp-tweetbinder):

```bash
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

1. Clone this repository
2. Install dependencies:
   ```bash
   npm install
   ```
3. Build the project:
   ```bash
   npm run build
   ```

You need a valid TweetBinder API Bearer Token to use this service; set it in your environment:

```bash
export TWEETBINDER_API_TOKEN='your-bearer-token-here'
```

## Usage with Claude Desktop

1. Edit your Claude Desktop configuration file:

   - **MacOS:**
     ```bash
     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     ```
   - **Windows:**
     ```bash
     code %AppData%\Claude\claude_desktop_config.json
     ```

2. Add this configuration:

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

3. Restart Claude Desktop

## Tools

## Available Tools

		1. `create-twitter-report` (Creates a new report that analyzes Twitter/X data based on a search query.)
		2. `create-twitter-count` (Creates a new report that counts tweets matching a search query.)
		3. `list-reports` (Retrieves a list of all your TweetBinder reports with sorting capabilities.)
		4. `get-report-content` (Retrieves the actual tweets or users from a generated report with advanced filtering and pagination.)
		5. `get-report-status` (Checks the current status of a TweetBinder report.)
		6. `get-report-stats` (Retrieves comprehensive statistics and analytics for a TweetBinder report.)
		7. `get-account-balances` (Retrieves information about your account's credit balance, usage, and remaining quota.)