7846 stories
·
34 followers

The NewsBlur CLI Tool, AI Skill, and MCP Server

2 Shares

NewsBlur has always had an API. Every feature in the web app, the iOS app, and the Android app runs through it. But APIs are for developers. Today I’m shipping three new ways to interact with your NewsBlur: a command-line tool that puts your entire NewsBlur in your terminal, an AI skill that teaches your agent every CLI command without eating your context window, and an MCP server that connects any MCP-compatible agent directly to your account.

Quickstart

CLI tool — install and log in:

uv pip install newsblur-cli
newsblur auth login

AI skill — install into Claude Code, Cursor, Windsurf, or any Skills-compatible tool:

npx skills add samuelclay/newsblur-cli-skill

MCP server — connect from Claude Code, Claude Desktop, Codex, or any MCP client:

claude mcp add --transport http newsblur https://newsblur.com/mcp/

All three require a Premium Archive or Premium Pro subscription. On first use, a browser window opens for OAuth authorization. Your token is stored locally and you can revoke access at any time.


CLI tool

Everything you do in NewsBlur, from your terminal. Full documentation is on the CLI feature page.

Read stories from feeds, folders, or everything at once:

newsblur stories list                          # unread stories
newsblur stories list --folder Tech --limit 5  # filter by folder
newsblur stories search "machine learning"     # full-text search
newsblur stories saved --tag research          # saved stories by tag
newsblur stories infrequent                    # rarely-publishing feeds
newsblur stories original 123:abc456           # fetch full article text

Get your daily briefing with AI-curated summaries:

newsblur briefing                              # today's briefing
newsblur briefing --limit 1                    # just the latest
newsblur briefing --json                       # structured output

Manage feeds and folders:

newsblur feeds list                            # all subscriptions
newsblur feeds folders                         # folder tree with counts
newsblur feeds add https://example.com         # subscribe
newsblur feeds add https://blog.com -f Tech    # subscribe into a folder
newsblur feeds remove 42                       # unsubscribe
newsblur feeds organize move_feed --feed-id 42 --from News --to Tech

Take actions on stories:

newsblur save 123:abc --tag ai --tag research  # save with tags
newsblur unsave 123:abc                        # remove from saved
newsblur read --feed 42                        # mark feed as read
newsblur share 123:abc --comment "Worth reading"

Train your intelligence classifiers:

newsblur train show --feed 42                  # view current training
newsblur train like --feed 42 --author "Name"  # train a like
newsblur train dislike --feed 42 --tag sponsor # train a dislike

Discover new feeds:

newsblur discover search "machine learning"    # search by topic
newsblur discover similar --feed 42            # find similar feeds
newsblur discover trending                     # trending feeds

Every command supports --json for structured output you can pipe to jq or use in scripts, and --raw for unformatted text. There’s also a global --server flag for self-hosted NewsBlur instances:

newsblur --server https://my-newsblur.example.com auth login
newsblur briefing --json | jq '.items[0].section_summaries'

AI skill

The CLI is great on its own, but it’s even better when your AI agent knows every command. The NewsBlur CLI skill teaches your agent the full command reference: every subcommand, every flag, every output format. Install it with one command and your agent can read feeds, search stories, train classifiers, and manage subscriptions on your behalf.

npx skills add samuelclay/newsblur-cli-skill

The npx skills add command works with any tool that supports the Skills standard: Claude Code, Cursor, Windsurf, and dozens more.

The skill has a major advantage over the MCP server for agents that support it: context efficiency. The MCP server returns raw JSON that lands in your agent’s context window. Ask for your saved ESP32 stories and you’ll burn through nearly 40,000 tokens on a single response. The skill runs the CLI instead, which returns clean, formatted text. Same query, same results, about a third of the tokens. In testing, the MCP server used 39,553 tokens for a saved stories query. The same query through the skill used 11,735.

If your tool supports skills, use the skill. If it only supports MCP, use the MCP server. If you just want to script your NewsBlur from the terminal, use the CLI directly.

MCP server

MCP (Model Context Protocol) is an open standard that lets AI agents connect to external tools and data. With the NewsBlur MCP server, Claude, Codex, Cursor, Windsurf, and any other MCP-compatible agent can read your feeds, manage your stories, train your classifiers, and organize your subscriptions.

The server exposes 22 tools that cover everything you do in NewsBlur:

Reading — List feeds and folders with unread counts. Load stories from any feed, folder, or all subscriptions at once. Filter by unread, focus, or starred. Search across your entire archive with full-text search. Pull the original article text from the source. Get your AI daily briefing. Browse stories from your rarely-publishing infrequent feeds.

Actions — Mark stories as read by hash, by feed, or by folder. Save stories with tags, notes, and highlights. Subscribe and unsubscribe. Move feeds between folders. Rename feeds and folders. Share stories to your Blurblog.

Intelligence — View your trained classifiers across all feeds. Train new likes and dislikes by author, tag, title, or text content. The full range of training levels is available, including the new super dislike that overrides all other positive scores.

Discovery — Search for new feeds by topic. Find feeds similar to ones you already follow. Browse trending feeds.

For Claude Code:

claude mcp add --transport http newsblur https://newsblur.com/mcp/

For Claude Desktop, add this to your claude_desktop_config.json:

{
  "newsblur": {
    "type": "http",
    "url": "https://newsblur.com/mcp/"
  }
}

Codex, Cursor, and Windsurf each have their own config format. Setup instructions for all of them are on the MCP Server feature page.

Readonly mode

Giving an AI agent access to your NewsBlur is powerful, but maybe you want to start with guardrails. The CLI has a readonly mode that blocks all write operations: no saving, no sharing, no training, no subscribing, no marking as read. Your agent can read your feeds and search your stories, but it cannot change anything.

newsblur auth readonly --on

With readonly on, any write command returns an error instead of executing. The agent sees your data but cannot touch it.

The important part is what happens when you turn it off. Disabling readonly mode logs you out and requires you to re-authenticate in the browser:

newsblur auth readonly --off
# "You have been logged out and must re-authenticate."
newsblur auth login

This is deliberate. An AI agent cannot silently toggle readonly off and start making changes. Only a human sitting at a browser can re-authorize write access. If you hand the CLI to an agent and want to be sure it stays read-only, it will.

Availability

The CLI, AI skill, and MCP server are available now for Premium Archive and Premium Pro subscribers. See the MCP Server and CLI Tool feature pages for full documentation.

If you have ideas for new tools, workflows, or improvements, please share them on the NewsBlur forum.

Read the whole story
cherjr
1 hour ago
reply
48.840867,2.324885
Share this story
Delete

Winds of Change are Coming, what you need to know

1 Share

Another great write-up from Antonio, follow his blog below.

Portugal Just Changed the Rules: What Every Resident, Expat & Visitor Needs to Know in 2026.

Please share this with friends and family on the Main-land, some of these will also apply to Madeira.

There’s a saying in Portugal — “devagar se vai ao longe” (slowly one goes far).

But in 2026, the Portuguese government has apparently decided to sprint. If you live here, plan to move here, or simply love visiting, buckle up — and I mean that literally, because the driving laws are changing too.

I’ll be honest: when I first started reading about the new legislation, I poured myself a generous glass of vinho tinto and settled in. Three hours and half a bottle later, I emerged with bloodshot eyes and a newfound appreciation for EU bureaucratic language. So you don’t have to suffer the same fate, here’s the breakdown — in plain English, with only mild existential dread.

The Big Picture: Why Is Portugal Changing Everything at Once?

Portugal has been on the world’s radar for the best part of a decade. Digital nomads, retirees, young professionals, investors — everyone seemed to discover this sun-soaked strip of Atlantic coastline at roughly the same time. And while that brought economic benefits (hello, craft beer bars in every neighbourhood), it also brought pressure: on housing, on public services, and on a legal framework that was, frankly, held together with cork and optimism.

The current government, inherited a system creaking under its own success. Their response?

A comprehensive legislative overhaul touching immigration, citizenship, road safety, taxation, housing, and healthcare. Think of it as Portugal hitting ctrl+alt+update on itself.

Immigration: The Door Is Still Open — But There’s a Bouncer Now.

Let’s start with the headline grabber. Portugal’s immigration laws have undergone their most significant restructuring in over a decade. The “manifestação de interesse” is gone. That informal pathway where you could arrive on a tourist visa and regularise your stay from within Portugal? History.

From 2026, all residency must be secured from your home country before you arrive. No more showing up with a suitcase and a prayer. A new “professional mobility visa” takes its place, targeting sectors Portugal actually needs: technology, healthcare, engineering. You have 120 days to demonstrate genuine employment once you’re here. It’s Portugal saying, “We still want you — but bring a job offer, not just vibes.

“The AIMA continues processing, and expired residence permits issued before June 2025 were automatically extended through April 2026. If you’re already here and legal, breathe. Your renewal process is getting smoother, not harder.

For D7 (passive income) and Digital Nomad visa holders, expect updated income verification requirements at renewal. The bar hasn’t changed dramatically, but the documentation standards have tightened. Think of it as Portugal asking to see the receipts.

Family reunification now requires two years of legal residency before you can bring over your spouse or children, plus proof of adequate housing and financial independence. Language and civic education participation is also part of the deal. It’s structured, it’s clear, and it’s designed to ensure families arrive into stable situations.

Citizenship: From Five Years to Ten. (For Most)m, this one has caused the most hand-wringing among the expat community, and understandably so.

For CPLP citizens (Brazilians, Cape Verdeans, Angolans, etc.), the residency requirement for naturalisation has risen from five to seven years. For everyone else, it’s now ten years. That puts Portugal in line with countries like Germany and Austria.The government’s logic is straightforward: citizenship should reflect genuine integration, not just time served.

You’ll need to demonstrate Portuguese language proficiency, knowledge of national history, and a clean criminal record. Children born in Portugal to foreign parents can receive citizenship once the parents have established three to five years of legal residency.If you’re married to a Portuguese citizen, the accelerated three-year pathway remains. Small mercies.

The honest take? Ten years is a long time. But Portugal isn’t closing the door to citizenship — it’s asking you to learn to speak Portuguese first. And honestly, if you’ve lived somewhere for a decade and still can’t order a bica without pointing, that’s on you.

Driving in Portugal: The Overhaul Everybody’s Talking About.

Now here’s where it gets personally relevant to anyone who’s ever knuckled their way around a Portuguese roundabout. Portugal’s road safety record is, to put it diplomatically, not great. Between 2014 and 2024, the country reduced road fatalities by just 0.6% — while the EU average dropped by 17.2%. With 58 road deaths per million inhabitants (compared to Sweden’s 20), Portugal is firmly in the “must do better” camp.

The response? A complete overhaul of the Código da Estrada (traffic code), a new Vision Zero strategy targeting 2030, and some changes that will affect every driver on Portuguese roads.What’s actually changing: Speeding penalties are getting serious. Speed remains the number one killer on Portuguese roads, and the government is rolling out expanded camera networks and stricter fines. The days of the “everyone does 140 on the A1” mentality are numbered. New cars from July 2026 will come equipped with driver distraction detection systems, intelligent speed assistance, and advanced emergency braking — all mandated by EU regulation. If you’re buying a new car in Portugal this summer, it’ll essentially tattle on you for checking your phone. 30 km/h zones are expanding in residential and high-pedestrian areas, following successful models in Belgium and Spain. If you live in a city, expect more zones where you’ll be driving slower than some people jog.

Mandatory alcohol interlock devices are expanding for drink-driving offenders. Get caught once, and your car might require you to blow into a tube before it starts.Traffic violation processing is being compressed from eight months to two. That means when you run that amber light in Cascais, you’ll hear about it while you still remember doing it. Every one of Portugal’s 308 municipalities must create a local road safety plan by late 2026. This is genuinely significant — it means your local câmara will be identifying the specific dangerous junctions, blind curves, and death-trap roundabouts in your area and actually doing something about them.

Driver’s Licence and Learner Driver Reforms.

The changes don’t stop at the roads — they extend to who’s behind the wheel and how they got there. The minimum age for a learner’s permit drops to 17, but with significant restrictions. Under-18 learners must complete a structured supervised driving programme with a minimum of 50 logged hours before sitting the practical test.

Think of it as Portugal adopting a version of the graduated licensing model used in Scandinavia and Australia — and honestly, it’s about time.

Provisional licence holders face new restrictions for the first two years. Zero alcohol tolerance (currently 0.2g/l for new drivers, now absolute zero), a ban on driving between midnight and 5am unless accompanied by a full licence holder, and a maximum of one non-family passenger under 25.

Harsh? Perhaps. But when you consider that drivers aged 18–24 are involved in a disproportionate number of fatal accidents in Portugal, the logic is hard to argue with.The theoretical driving test is being modernised. The old multiple-choice exam — which many instructors admit was more about memorising trick questions than understanding road safety — is being replaced with scenario-based testing.

You’ll watch video clips of real traffic situations and respond in real time. It’s a fundamental shift from “do you know the rule?” to “can you apply it?” Driving school oversight is tightening. All instructors must complete updated certification by the end of 2026, and driving schools will face regular audits. The days of the dodgy escola de condução that passes everyone with a pulse are, theoretically, numbered.

International and foreign licence holders take note: Portugal is aligning more closely with EU directive requirements on licence exchange. If you hold a non-EU licence and have been relying on an international driving permit indefinitely, the grace period is being formalised. After 185 days of residency, you’ll need to exchange or convert your licence. The process is being streamlined, but the deadline is firm.

For EU licence holders, the rules remain broadly the same — your licence is valid. But if you’ve been here more than two years without updating your address on file, there’s a new administrative requirement to register your licence with the IMT. It’s a formality, but failing to do it could complicate things if you’re stopped.

If you’re renting a car in Portugal — and especially if you’re visiting for the first time — these changes make it more important than ever to understand the local rules.

Housing: 250,000 Empty Homes Are About to Hit the Market.

Portugal has a housing crisis. This isn’t news. But the government’s proposed solution is genuinely interesting.Inheritance law reform is targeting an estimated 250,000 properties stuck in legal limbo — homes in perfectly good condition that have been locked in inheritance disputes for years, sometimes decades. The new framework streamlines private dispute resolution among heirs and reduces bureaucratic friction.Another 130,000 properties need rehabilitation, creating both housing supply and economic stimulus. The government estimates these homes could start reaching the rental and sale markets within 6–18 months.

For renters: rent increases on new contracts for previously rented properties are capped at 2% annually. That’s real protection in a market where Lisbon rents have felt like they’re competing with London. For property owners: if you convert an Alojamento Local (short-term rental) unit into a long-term rental, you get income tax exemptions through 2029. The government is essentially paying you to stop being an Airbnb landlord.

Construction and rehabilitation projects for permanent housing or affordable rental benefit from a reduced 6% VAT rate. And there’s an emergency housing fund covering rent arrears for vulnerable households.

Taxation: More Money in Your Pocket (Slightly).

The tax changes are less dramatic but worth knowing: The minimum wage rises to €920/month, up €50. Income tax rates drop 0.3 percentage points on brackets 2 through 5, and brackets are updated 3.5% above inflation. The minimum subsistence level ensures the minimum wage remains income tax free.Corporate tax drops to 19%, heading towards 17% by 2028.

If you run a business in Portugal, the trajectory is clear: the government wants to make the country more competitive.

Healthcare and Education: Quiet Improvements.

A new dental health programme extends free dental care to children and young people aged 2–18 through dentist vouchers accessible via the SNS 24 app. It’s the kind of quiet, practical reform that doesn’t make headlines but genuinely improves lives.

Student housing gains 4,629 new beds. First-cycle schools get 430 new libraries. A new Research and Innovation Agency ensures five-year budget stability for researchers. And the Fun One: Formula 1 Returns. Yes, buried in the government’s official “What’s New in 2026” announcement is this gem: Portugal is back on the Formula 1 calendar with the Algarve Grand Prix for the next two years. If you needed one more reason to visit the Algarve, there it is. And if you’re planning the trip, you’ll want your own wheels — the Autódromo do Algarve isn’t exactly on the bus route.

What Should You Actually Do?

If you’re an existing resident: check your permit renewal status with AIMA. Make sure your documentation is up to date. If your renewal is due within the next 12 months, start preparing now.If you’re planning to move to Portugal: secure your visa from your home country before arriving. The informal routes are closed. Get professional immigration advice if you’re unsure which visa category applies to you.

If you’re visiting or driving in Portugal: familiarise yourself with the new road rules, respect the speed limits (they’re actually enforcing them now), and sort your car hire in advance — prices spike in summer and the best deals go quickly.If you’re a property owner: look into the tax incentives for converting short-term rentals to long-term lets. The maths might surprise you.

If you’re waiting for citizenship: patience. The timeline has extended, but the pathway remains clear. Use the time to genuinely integrate — learn the language, get involved in your community, understand the culture. When you do eventually get that Portuguese passport, it’ll mean something.

The Bottom Line.

Portugal isn’t becoming less welcoming. It’s becoming more deliberate.

The country is moving from “everyone’s welcome, figure it out when you get here” to “you’re welcome if you’re prepared, committed, and willing to contribute.”

Given the pressures of the last decade, that’s not unreasonable.The road safety changes are long overdue. The housing reforms could be transformative. The immigration restructuring brings Portugal in line with the rest of Western Europe.

And Formula 1 is back!

Not bad for a country that still hasn’t figured out how to queue properly.

*Have questions about how these changes affect you? Drop them in the comments or reach out — we’re all navigating this together, one bureaucratic form at a time.*

Please visit my Blog for more: https://www.vagabond.to

Read the whole story
cherjr
3 days ago
reply
48.840867,2.324885
Share this story
Delete

Анекдот дня по итогам голосования за 25 марта 2026

1 Share
Госдума заявила о полном импортозамещении санкций. С сегодняшнего дня Россия всё запрещает себе сама, не пользуясь никакими западными запретами.
Read the whole story
cherjr
6 days ago
reply
48.840867,2.324885
Share this story
Delete

Анекдот дня по итогам голосования за 21 марта 2026

1 Share
Долой англицизмы!
Не бизнес-леди, а базарная баба!
Read the whole story
cherjr
8 days ago
reply
48.840867,2.324885
Share this story
Delete

Фраза дня по итогам голосования за 17 марта 2026

1 Share
Хорошо, когда аппетит приходит во время еды. Не очень хорошо, когда аппетит приходит после еды. И совсем плохо, когда аппетит появляется вместо еды.
Read the whole story
cherjr
15 days ago
reply
48.840867,2.324885
Share this story
Delete

О результатах муниципальных выборов во Франции и прорыве крайне левых: - Какой ...

1 Share

О результатах муниципальных выборов во Франции и прорыве крайне левых:

- Какой же ужасно высокий результат у «Непокорной Франции», несмотря на все их антисемитские заявления.
- Дорогая, это не «несмотря», это «благодаря».

Read the whole story
cherjr
16 days ago
reply
48.840867,2.324885
Share this story
Delete
Next Page of Stories