How to Use the Wallabag (Pocket Alternative) MCP in Windsurf

Q: How do I search for specific articles using Wallabag (Pocket Alternative) and Windsurf?

You first run listentries to see everything saved. Then, Cascade reads the list context and uses the IDs you provide to call getentry. This lets your agent focus only on the articles you care about.

Q: Can Windsurf automatically tag new Wallabag (Pocket Alternative) entries?

Yes. After saving a URL via createentry, Cascade can immediately call addtagstoentry. This lets your agent categorize the article as soon as it hits your read list.

Q: How do I check my annotations using Wallabag (Pocket Alternative) and Windsurf?

You simply tell Cascade the entry ID. It runs listannotations against that specific ID, pulling all the notes written for that article so you don't have to manually go through every saved item.

Manage your read-it-later list with Windsurf's autonomous multi-step execution.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Wallabag (Pocket Alternative) MCP to Windsurf

Create your Vinkius account to connect Wallabag (Pocket Alternative) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Wallabag (Pocket Alternative) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Organize and categorize saved articles.

You tell Cascade to tag a bunch of entries, and it handles the whole sequence. Use `create_entry` to save a URL first, then trigger `add_tags_to_entry` or `remove_tag_from_entry` to sort that article later. Cascade reads your goal—say, 'Find all unread tech articles'—and automatically chains calls to `list_entries`, filters them, and checks the read status using `mark_entry_read`.

Track and annotate saved content.

Need more context on an article? Cascade can get all entries with `get_entry` and then append notes. It uses the `create_annotation` tool to attach specific comments, letting you keep track of your thoughts right inside Wallabag (Pocket Alternative). If you want a summary of existing notes, just run `list_annotations`. This is how Windsurf’s MCP Server helps you build deep context around saved content.

Maintain an organized reading list.

Keeping your list clean is key. If you find a broken link or need to delete something, Cascade just needs the ID. Use `delete_entry` when an article is junk, or use `list_entries` and then `mark_entry_favorite` on anything worth saving. The Windsurf MCP Server makes sure your reading list stays actionable. It lets you check if an item was marked as read with `mark_entry_read`.

Setup guide

Set up Wallabag (Pocket Alternative) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Wallabag (Pocket Alternative) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Wallabag (Pocket Alternative) payment history." If connected, Cascade will call the Wallabag (Pocket Alternative) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "wallabag-pocket-alternative-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Wallabag. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Wallabag (Pocket Alternative) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Wallabag (Pocket Alternative) MCP in Windsurf

You first run `list_entries` to see everything saved. Then, Cascade reads the list context and uses the IDs you provide to call `get_entry`. This lets your agent focus only on the articles you care about.

Yes. After saving a URL via `create_entry`, Cascade can immediately call `add_tags_to_entry`. This lets your agent categorize the article as soon as it hits your read list.

You simply tell Cascade the entry ID. It runs `list_annotations` against that specific ID, pulling all the notes written for that article so you don't have to manually go through every saved item.

Yes. This MCP Server touches entry URLs and annotations. All interaction is managed by your AI client, ensuring that the data exchange stays within your defined context boundaries.

You initiate a goal—like 'clear all junk links.' Cascade executes `list_entries` first, letting you review the IDs, then it calls `delete_entry` on those specific items for you.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript