Run the TweetBinder agent and tools securely in the cloud using Meshagent Rooms.

Environment Variables Needed:

  • TWEETBINDER_API_TOKEN – Your TweetBinder API bearer token.

Steps:

  1. Install Meshagent CLI:

    pip install "meshagent[all]"

  2. Sign up and Authenticate with Meshagent:

  3. Start MCP TweetBinder as a Meshagent Service Room:

    meshagent service test --room=test --role=agent --image=meshagent/mcp-tweetbinder:latest \
  --env MESHAGENT_PORT=8001 --env TWEETBINDER_API_TOKEN=your-bearer-token-here \
  --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
  --name=mcp-tweetbinder-service
    • This command will launch a Meshagent room hosting the MCP TweetBinder server.
    • Replace your-bearer-token-here with your TweetBinder API token.
    • Rooms will close automatically if they go inactive.

  4. Join and Use the TweetBinder Tools with an Agent (Chatbot) in the Room:

    meshagent chatbot join --room=test --agent-name=sample --name=sample --toolkit=mcp-tweetbinder
    • Starts a chatbot linked to the TweetBinder toolkit within the room.
    • You may use multiple toolkits in the same room for richer interactions.
    • The CLI output will provide a link to the room for web or API-based interaction with the agent and tools.

​
Tools Available

The following tools are available through the MCP TweetBinder server when used with Meshagent Rooms:

ToolShort Description
create-twitter-countCreates a new report that counts tweets matching a search query.
create-twitter-reportCreates a new report that analyzes Twitter/X data based on a search query.
get-account-balancesRetrieves information about your account’s credit balance, usage, and remaining quota.
get-report-contentRetrieves the content (tweets or users) of a TweetBinder report.
get-report-statsRetrieves comprehensive statistics and analytics for a TweetBinder report.
get-report-statusChecks the current status of a TweetBinder report.
list-reportsRetrieves a list of all your TweetBinder reports.

​
Tool Details

​
create-twitter-count

Creates a new report that counts tweets matching a search query. Returns raw JSON response.

ParameterTypeDescription
querystringThe search query for Twitter data. Can include operators like AND, OR, hashtags, mentions, etc.
reportTypestring, optionalType of report to create: ‘7-day’ for last week or ‘historical’ for all time.

​
create-twitter-report

Creates a new report that analyzes Twitter/X data based on a search query. The report provides statistics and tweet data. Returns raw JSON response.

ParameterTypeDescription
querystringThe search query for Twitter data. Can include operators like AND, OR, hashtags, mentions, etc.
endDatenumber, optionalEnd date as Unix timestamp (seconds since epoch).
limitnumber, optionalMaximum number of tweets to retrieve (up to 50,000).
reportTypestring, optionalType of report to create: ‘7-day’ for last week or ‘historical’ for all time.
startDatenumber, optionalStart date as Unix timestamp (seconds since epoch).

​
get-account-balances

Retrieves information about your account’s credit balance, usage, and remaining quota. Returns raw JSON response.

​
get-report-content

Retrieves the content (tweets or users) of a TweetBinder report. The report must be in ‘Generated’ status. Returns raw JSON response.

ParameterTypeDescription
contentTypestringThe type of content to retrieve: ‘tweets’ for tweet IDs or ‘users’ for user IDs.
reportIdstringThe ID of the report to retrieve content for.
filterstring, optionalJSON string with filter criteria. Example: {"counts.favorites":{"$gt":10}}
pagenumber, optionalPage number for pagination. Starts at 1.
perPagenumber, optionalNumber of items per page (default varies by endpoint).
sortBystring, optionalField to sort by (e.g., ‘createdAt’, ‘counts.favorites’).
sortDirectionstring, optionalSort direction: ‘1’ for ascending, ‘-1’ for descending.

​
get-report-stats

Retrieves comprehensive statistics and analytics for a TweetBinder report. The report must be in ‘Generated’ status to access statistics. Returns raw JSON response.

ParameterTypeDescription
reportIdstringThe ID of the report to retrieve statistics for.

​
get-report-status

Checks the current status of a TweetBinder report. Returns raw JSON response.

ParameterTypeDescription
reportIdstringThe ID of the report to check.

​
list-reports

Retrieves a list of all your TweetBinder reports. Reports can be sorted by different fields. Returns raw JSON response.

ParameterTypeDescription
orderstring, optionalOptional sorting parameter in the format ‘fielddirection’. Example: ‘createdAt-1’ for newest first, ‘createdAt1’ for oldest first.