TweetsmashDocs
LoginDashboard
Getting Started
Getting Started
For AI agents
OverviewConnect your agentAgent Skills
MCP
MCP Integration
Bookmarks
GETFetch Saved PostsGETGet a Bookmark (full content)
Labels
GETManage LabelsPOSTAdd Labels to TweetsPOSTRemove Labels from TweetsPOSTAdd Labels by Filter (bulk)
Smart Views
GETList Smart ViewsGETGet / Update / Delete a Smart ViewGETGet Smart View Bookmarks
Exports
POSTExport Bookmarks (PDF / CSV / JSON)
Memory
GETMemories (remember / recall / forget)
Integrations
n8n IntegrationWebhook Integration
API docs/For AI agents/Overview
For AI agents

Use Tweetsmash from an agent

Give Claude, ChatGPT, Cursor, Codex, or any MCP client access to a user's X (Twitter) bookmarks — read full content, search, organize, run smart views, share, export, and discover high-signal tweets — over MCP or REST.

Three steps

1

Get an API token

Create a token under Developer API. It authenticates every MCP and REST call.

2

Connect

Point your agent at the hosted MCP server (recommended) …

mcp config
{
  "mcpServers": {
    "tweetsmash": {
      "url": "https://mcp.tweetsmash.com/api/mcp?token=YOUR_API_TOKEN"
    }
  }
}

… or call the REST API directly:

bash
curl https://api.tweetsmash.com/v1/bookmarks \
  -H "Authorization: Bearer YOUR_API_TOKEN"
See Connect your agent for per-client config (Claude, Cursor, VS Code, Codex, OpenClaw, ChatGPT, and more).
3

Install the skill (optional, recommended)

The Tweetsmash agent skill teaches your agent the full tool catalog and how to use it well:

bash
npx skills add tweetsmash/agent-skills

What the agent can do

Read & search

Keyword + semantic search, and read a saved tweet's full X Article body, unrolled thread, and notes in one call.

Organize

Label, archive, and delete — one by one or in bulk by filter — and create and run Smart Views.

Share & discover

Create share links, and surface the top/trending tweets from a followed Twitter list (and email a digest).

Export & remember

Export to PDF/CSV/JSON, manage email digests, and remember durable preferences across sessions.
Reading bookmarks works on the Free plan (limited). Filters, pagination, semantic search, exports, and writes need a paid plan; those calls return HTTP 402 with an upgrade URL so your agent can prompt the user instead of failing.

Next

Connect your agent

Copy-paste config for every major client.

MCP tools

The full tool catalog, grouped.

Agent Skills

Install the skill into Claude Code, Cursor, and more.