Skip to content

Hei33enberg/RAK-OS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RAK OS — media without an owner, in every country

RAK OS is an open content language for the agentic web + a free stack: give any country's media back to its people. The @rak-ad/mcp Model Context Protocol client connects any AI agent to the RAK network. Poland (rak.guru) is the first live node — the proof: 4,800+ monitored local sources, 16 regions, hybrid RAG and a wire feed, 24/7, free for readers. Your country is next — fork a node.

🕊️ Manifesto: MANIFESTO.md (PL) · 👑 The Realm: REALM.md · 🏛️ Governance: GOVERNANCE.md

🌍 Site/docs: https://rak.guru/mcp · 📦 npm: @rak-ad/mcp · 🔌 Remote: https://rak.guru/api/mcp/rak/mcp

📜 RAK language spec (v0.2): SPEC.md — the open standard "write once → own it → cited by every agent". One envelope for content and market (FOP profile).

💸 Economics (the moat): ECONOMICS.md — pay-per-AI-citation. Our own valuation + settlement layer; Stripe Connect is a swappable last-mile plugin.

@rak-ad/mcp connects Claude Desktop, Cursor, Windsurf, ChatGPT and any MCP agent to a RAK node. The reference node today is Poland (rak.guru / Kanał ZERO) — the live test — plus universal editorial tools (research + write). The same rak_<module>_<operation> tools work for any node you run.


What is RAK OS? (TL;DR)

RAK OS is how any country gives its local media back to its people: an open format + free tools any AI agent can read, and any community can run. Poland is the first live node — the test. If you build an AI agent and need fresh local information — from a specific region, county or city — the RAK node gives you that in one connection instead of scraping dozens of portals: a hybrid search, per-region feeds, a wire feed, and 4,800+ monitored sources (incl. a curated census of 1,709 local outlets). Reader tools are free and work anonymously (no key). Your country is next — fork a node.

What you get

  • 🔎 Instant content — hybrid search (FTS + semantics), articles, wire feed, feeds for all 16 regions, 4,800+ monitored sources (curated census of 1,709 local outlets).
  • 🧠 Research — web search with citations, RAG over the archive, URL → markdown extraction.
  • ✍️ Creation (subscribers) — drafts, editorial plans, the full pipeline (research → write → fact-check), media (image/video/TTS).
  • QA (subscribers) — fact-check, moderation, uniqueness.
  • 🌍 Free discoveryrak_meta_* and rak_content_* anonymously, no key. A free index of the node — Poland today, your country next.

Quickstart

Claude Desktop / Cursor / Windsurf — mcp.json

{
  "mcpServers": {
    "rak": {
      "command": "npx",
      "args": ["-y", "@rak-ad/mcp"],
      "env": {
        "RAK_API_KEY": "rk_...",        // omit for anonymous (reader) access
        "RAK_BASE_URL": "https://rak.guru"
      }
    }
  }
}

Remote (server agents) — Streamable HTTP

POST https://rak.guru/api/mcp/rak/mcp
Authorization: Bearer <RAK_API_KEY>     # omit for the anon tier
Api-Version: 2026-05

Inspect / smoke

npx @modelcontextprotocol/inspector

Access tiers

Tier Key Scope
anon (reader) no content_*, rag_*, meta_* — search, wire, region feeds, source census
free yes as above + higher limits
paid (subscriber) yes + writing, media, fact-check, full RAG (on credits)
partner yes read-only (content + optionally RAG)
internal yes full (publishing + distribution)

Tool catalog (rak_<module>_<op>) — 54 tools

Authoritative surface: rak_meta_list_skills / schemas/tools.manifest.json.

Module Tools Tier
content search, get_article, list_section, wire_feed, region_feed · create_poll (paid) anon (reader)
rag find_related, semantic_search, search_chunks anon (reader)
voice search — persona-knowledge RAG (a public figure's own words, source-backed) anon (reader)
legal search — Polish-law corpus (ELI/ISAP), citable statute fragments anon (reader)
meta list_sources, list_skills, health, list_agents anon / discovery
irc list_channels, read_channel, presence, post, create_channel anon read / free post
murl list_channels, read, presence, open, post — rooms anchored to any URL/domain anon read / free post
research web, extract, fact_pack, summarize, deep anon → paid
write draft, edit, plan, pipeline, publish, export, debate, document paid → internal
media generate_image, generate_video, generate_song, storyboard, tts paid
qa fact_check, moderate, uniqueness paid
owned publish, list, get, verify creator (paid+)
crawl / distribution crawl_search, crawl_add_source, crawl_subscribe, distribution_publish internal

Per-skill details: skills/.

Examples (for agents)

  • Regional news: rak_content_region_feed({ region: "mazowieckie", limit: 20 })
  • Topic search: rak_content_search({ query: "local government budget", section: "politics" })
  • Local source census: rak_meta_list_sources({ voivodeship: "malopolskie" })
  • Fresh wire: rak_content_wire_feed({ minScore: 70, limit: 25 })

FAQ

Is RAK OS free? Yes — reader tools (content, search, wire, region feeds, source census, RAG, persona/law search, and reading chat) are free and anonymous. Only the creative RAK tools for subscribers are paid.

How fresh is the data? The pipeline harvests and processes sources 24/7, in 10–15 minute cycles. The rak://health resource shows freshness and 24h volume.

How many sources? On the first node (Poland): 4,800+ monitored sources live right now — local portals, X accounts, RSS feeds, YouTube channels (live count: rak_meta_health.enabledCrawlSources) — including a curated census of 1,709 local media outlets across 16 regions (regional dailies, county portals, radio, TV, public bulletins) with per-region metadata via rak_meta_list_sources. Every country's node runs its own census.

How is it different from RSS/an API? It's an agent-native interface — ready, described tools with semantics, freshness and citations, working out of the box in any MCP client.

Commercial use? The @rak-ad/mcp client is MIT-licensed; access to content/tools follows the RAK ToS. Dedicated keys for partners/enterprise.

API keys

Reader tools need no key. An rk_ key (tier paid/partner/internal) is issued by the RAK team — contact via https://rak.guru. Scopes: content:read, skills:action. Keys are tenant-scoped.

Links

Who's behind this

RAK OS is an independent, self-funded project — no venture capital, no private equity, no big-media owner. It exists to keep local media out of the hands that usually capture it: legacy holdings and platform gatekeepers (News Corp, Axel Springer, Meta, TikTok, Google News, Amazon) that decide what most people read. On scanning mandates like Chat Control, the stance is plain: we would leave a market before wiring a scanning backdoor into a reader — see the Manifesto. It is a kingdom, honestly: one maintainer (the Crown, @Hei33enberg) holds the vision and the last word; the community builds and is credited in the open (REALM.md). Why this structure — and how it's kept hard to capture — is in the Manifesto and the Realm's absorption-proofing section.

Build your own RAK

The OS is MIT — fork your country's RAK, for free, forever.

  • Build an agent on RAK: speak rak_* directly today — connect over MCP against the SPEC.md, share one base and one citation market. Ship it and it's discoverable via rak_meta_list_agents. A one-command npx create-rak-agent scaffold is on the roadmap.
  • Run a national/vertical node: stand up your own RAK node → become a Node Sovereign (REALM.md, L5). The RAK trademark and origin brand stay with the Crown (TRADEMARK.md); everything else is yours.
  • Start from SPEC.md (the contract) and the skills.

One language — content + market

RAK's content object shares a base envelope (SPEC.md §3.1) with a sibling protocol, POXI / FOP (opinions → listings → gigs). One kind/ext/wallet/interop base means an agent speaks both content and market in one language. Mapping: docs/profiles/fop.md. Two independent implementations of one envelope is the network effect the language is built for.

Built on Open Mercato

RAK (and POXI) run on Open Mercato — an open, inspectable runtime engine. We didn't reinvent the foundation; durability comes from boring, auditable infrastructure. If you want the same operational certainty under your own node, that's the engine.

Community

  • Discussions: GitHub Discussions (once enabled) — questions, RFCs, show-and-tell.
  • Contribute: CONTRIBUTING.md — humans and AI agents both (AGENTS.md).
  • Chat: the RAK app ships a built-in community chat (an in-app client feature, mIRC-style). The rak_irc_* / rak_murl_* MCP tools are the agent bridge into those same channels (anon read, free post) — not a separate chat product. RFC 0001 tracks the fuller native-chat vision.

Companion project — Strajk Polski

RAK = fresh local news & knowledge about Poland. Strajk Polski = hard, verified fiscal & political open data (national debt, the budget, all 460 MPs, Sejm votes, the map of government) + RAG. Together: all of Poland for AI agents, in one place.

License

MIT (client). Access to content/API follows the RAK ToS.


Tags: open content language · media without an owner · local news for AI agents · agentic web · content provenance · pay-per-AI-citation · model context protocol · RAG · fork a node · Poland (first node) · Kanał ZERO · RAK.AD · Claude · Cursor · Perplexity

About

RAK OS — media without an owner. An open content language + free MCP stack that gives any country's media back to its people. Poland is the first live node: 4,800+ monitored sources, 16 regions, RAG, wire, chat — 54 tools for AI agents, readers free & anonymous. Fork a node; your country is next.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors