> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twixb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
pip install twixb-mcp
# or run without installing:
uvx twixb-mcp
```

## Configure Claude Desktop

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

```json theme={null}
{
  "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       |