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

Getting Started

Integrations

MCP Server

MCP Server

Install

Configure Claude Desktop

Configure Cursor

Available tools

Example usage

Environment variables

​MCP Server

​Install

​Configure Claude Desktop

​Configure Cursor

​Available tools

​Example usage

​Environment variables

MCP Server

Install

Configure Claude Desktop

Configure Cursor

Available tools

Example usage

Environment variables