Agents can't act on what they can't perceive.
Website · Quick Start · Sensors · SensorHub · Docs · Community
World2Agent (W2A) is an open protocol that standardizes how AI agents perceive the real world. Install a sensor, your agent gets structured, real-time data. Swap sensors freely — they all speak the same schema.
W2A isn't a product. It's an open protocol and an invitation. We built the first sensors — the real breakthroughs will come from the community.
World → Sensor → Agent
Sensors watch data sources and emit structured data following W2A Protocol. Your agent receives signals and decides what to do.
→ Signal format spec · Architecture deep dive
The fastest way to feel W2A is with Claude Code. In an active session, install the world2agent plugin:
/plugin marketplace add machinepulse-ai/world2agent-plugins
/plugin install world2agent@world2agent-plugins
/reload-plugins
Add a sensor — for example, Hacker News stories, frontier AI lab posts:
/world2agent:sensor-add @world2agent/sensor-hackernews
/world2agent:sensor-add @quill-io/sensor-frontier-ai-news
→ Browse the full catalog on SensorHub.
Restart Claude Code with the plugin channel loaded so sensor signals flow into your session:
claude --dangerously-load-development-channels plugin:world2agent@world2agent-pluginsSecurity — install only sensors you trust. A sensor's signals drive what your agent perceives and does, so an untrusted sensor is effectively an untrusted instruction source. Stick to open-source sensors from authors you trust, and review the code first.
Native integrations for other agent runtimes are coming soon.
Integrating W2A into your own agent system? See the developer quick start for the SDK code path.
→ Full guide · Multi-sensor · SensorHub
SensorHub is the catalog of every W2A sensor — official and community-built, organized by what each one perceives (markets, news, production alerts, weather, AI labs, …). Browse it to see what's available, view each sensor's signal schema, and grab the one-line install command. Looking for a sensor? Start here.
Every sensor is a standard npm package — npm search w2a-sensor works as a fallback if you prefer the raw view.
Build your own in ~50 lines. The build-w2a-sensor skill walks an AI coding agent through discovery, signal design, scaffolding, and the install recipe — install it with:
npx skills add https://github.com/machinepulse-ai/world2agent/skills/build-w2a-sensorOnce it's ready, ship it to npm:
npm publishThat's it — your sensor is now installable by anyone, anywhere.
- Graph layer — compose and enrich signals from multiple sensors before they reach your agent. → RFC
-
🔧 Build a sensor —
npm publishand it's live -
🐛 Report bugs — open an issue
-
💡 Suggest a sensor — Discussions
Website · X / Twitter · YouTube · Discord
Built by MachinePulse · Open source, open protocol, open invitation.