MCP Integration

Connect AI assistants to your TweetsMash bookmarks using the Model Context Protocol (MCP). Enable AI tools to search, filter, and manage your bookmarks through natural language commands.

∞

What is MCP?

The Model Context Protocol (MCP) is a standard that allows AI assistants to securely access external data and tools. Our TweetsMash MCP service provides AI tools with direct access to your bookmarks, enabling powerful automation and organization capabilities.

💬

Natural Language

Ask your AI assistant to find and organize bookmarks using simple commands

🔍

Smart Search

AI-powered search through your bookmarks with semantic understanding

📁

Auto Organization

Automatically categorize and label bookmarks based on content

Prerequisites

TweetsMash API Token

Generate an API token from your TweetsMash account settings

MCP-Compatible AI Assistant

Use any AI assistant that supports the Model Context Protocol (Claude, Gemini, etc.)

TweetsMash MCP Service

Install and configure the TweetsMash MCP service on your system

🚀 Getting Started

Step 1: Generate TweetsMash API Token

Visit your TweetsMash account and generate an API token:

Go to your TweetsMash dashboard
Navigate to Settings → Integrations → API
Click "Generate New Token"
Copy the generated token (you'll need this for the next step)

Step 2: Choose Your Setup Method

Manual Configuration

Set up the MCP service locally using STDIO transport.

STDIO Configuration:

{
  "mcpServers": {
    "tweetsmash": {
      "command": "npx",
      "args": ["@tweetsmash/mcp"],
      "env": {
        "TWEETSMASH_TOKEN": "your-token-here"
      }
    }
  }
}

Config file locations:

• Claude: ~/.claude/claude_desktop_config.json
• Other clients: Check your client's documentation

Smithery

Use Smithery to deploy and manage your MCP server with zero configuration.

Quick Setup:

1. Visit Smithery TweetsMash Server
2. Choose your preferred connection method
3. Add your TweetsMash API token when requested

Step 3: Test Your Connection

Once configured, test the connection by asking your AI assistant:

Try these commands:

• "Show me my recent bookmarks"
• "Find bookmarks about technology"
• "How many bookmarks do I have?"
• "List my labels"

Available Tools

API Endpoints Reference

The MCP tools internally use these TweetsMash API endpoints. You can also use them directly in your applications:

GET /v1/bookmarks

Retrieve bookmarks with filtering and pagination. Used by the list_bookmarks and search_bookmarks tools.

GET /v1/labels

Get all user labels. Used by the list_labels tool.

POST /v1/labels/add

Add labels to tweets. Used by the add_labels_to_tweets tool.

Supported AI Clients

Claude Desktop

Official Claude desktop application with MCP support. Documentation

Config: ~/.claude/claude_desktop_config.json

Raycast

Raycast AI with MCP integration.

Config: Raycast documentation

Other MCP Clients

Any AI assistant that supports the Model Context Protocol.

Check your client's documentation for MCP setup

Frequently Asked Questions

How does the AI assistant access my bookmarks?

The AI assistant connects to your TweetsMash account through the MCP protocol using your API token. Your data remains secure and is only accessed when you make specific requests.

Can I customize the AI assistant's behavior?

Yes! You can provide specific instructions to the AI assistant about how you want it to organize, categorize, or present your bookmarks. The AI learns from your preferences over time.

Is my data secure?

Absolutely. Your API token is encrypted and the AI assistant only accesses your bookmarks when you explicitly request it. No data is stored or shared with third parties.

What's the difference between Smithery and manual setup?

Smithery provides a managed, hosted solution with automatic updates and zero maintenance. Manual setup gives you full control but requires you to manage the server yourself.

Additional Resources

MCP Documentation

Smithery TweetsMash Server

MCP Service Source Code