Skip to main content

​
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

ToolDescription
list_newsfeedsList all your newsfeeds
get_newsfeedGet newsfeed details
create_newsfeedCreate a new newsfeed
update_newsfeedUpdate newsfeed settings
delete_newsfeedDelete a newsfeed
list_sourcesList sources in a newsfeed
add_sourceAdd a content source
validate_sourceCheck if a URL is crawlable
delete_sourceRemove a source
search_postsSearch and filter posts
get_postGet full post with content
mark_post_readMark post as read
mark_post_unreadMark post as unread
hide_postHide a post
list_listsList reading lists
create_listCreate a reading list
get_listGet list with items
add_to_listSave post to list
remove_from_listRemove 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

VariableRequiredDefaultDescription
TWIXB_API_KEYYes—Your twixb API key
TWIXB_API_URLNohttps://twixb.com/apiAPI base URL