MCP Server

Connect twixb to Claude Desktop, Cursor, and other AI assistants via MCP.

MCP Server

The twixb MCP server lets AI assistants like Claude Desktop and Cursor manage your newsfeeds, read posts, and organize content — all through natural language.

Install

pip install twixb-mcp
# or run without installing:
uvx twixb-mcp

Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twixb": {
      "command": "uvx",
      "args": ["twixb-mcp"],
      "env": {
        "TWIXB_API_KEY": "twxb_your_key_here",
        "TWIXB_API_URL": "https://twixb.com/api"
      }
    }
  }
}

Configure Cursor

Add the same configuration to your Cursor MCP settings.

Available tools

Tool	Description
list_newsfeeds	List all your newsfeeds
get_newsfeed	Get newsfeed details
create_newsfeed	Create a new newsfeed
update_newsfeed	Update newsfeed settings
delete_newsfeed	Delete a newsfeed
list_sources	List sources in a newsfeed
add_source	Add a content source
validate_source	Check if a URL is crawlable
delete_source	Remove a source
search_posts	Search and filter posts
get_post	Get full post with content
mark_post_read	Mark post as read
mark_post_unread	Mark post as unread
hide_post	Hide a post
list_lists	List reading lists
create_list	Create a reading list
get_list	Get list with items
add_to_list	Save post to list
remove_from_list	Remove post from list

Example usage

Once configured, you can ask your AI assistant things like:

• “List my twixb newsfeeds”
• “Show me unread posts from my AI Research feed”
• “Create a new newsfeed for marketing trends”
• “Add techcrunch.com as a source to my startup feed”
• “Save this post to my reading list”

Environment variables

Variable	Required	Default	Description
TWIXB_API_KEY	Yes	—	Your twixb API key
TWIXB_API_URL	No	https://twixb.com/api	API base URL