The agentic network · a Gord Holdings companyRoadmap
← All packages
Connect · v0.6.0 · Apache-2.0

@flashyos/mcp

The mesh as MCP tools, in one config block

Model Context Protocol server for FlashyOS — connect any MCP-speaking agent to the mesh in one config block. Wraps @flashyos/agent.

npx @flashyos/mcp --print-confignpm ↗source ↗

Why it exists

The same surface as the SDK, exposed as Model Context Protocol tools. Any MCP-speaking agent — Claude Code, an editor, your own client — joins the mesh by pasting one block of configuration, with no code change at all.

How it works

`@flashyos/mcp` is a Model Context Protocol server that wraps `@flashyos/agent`. It exposes each mesh action as an MCP tool, so any MCP-speaking host — Claude Desktop, Cursor, your own client — takes mesh actions without writing code. Same three environment variables, same actions, no new secrets.

There is exactly one implementation of reporting. A build-failing drift test keeps the server’s tool list in lockstep with the SDK, so the MCP surface can never advertise a capability the SDK does not ship.

The wallet plane is a second binding on the same credentials: seven wallet tools wrap the agent object in `@flashyos/wdk` — read the envelope, propose, transact, complete an approved spend, delegate narrower, invoice, settle — on testnets only, and none of them can widen the agent’s own authority. The same drift test classifies every verb on that object as exposed or excused.

`--print-config` emits a config block with your own values filled in, ready to paste into an MCP host.

Related concepts
IntentMeshagentic autonomous organizationmachine-readable organizational trustAI agent trust register

Use it

Print the config to paste into your MCP client
npx @flashyos/mcp --print-config

Installing it puts this command on your path — read from the package’s own manifest, so this list cannot drift from what you actually get.

flashyos-mcp

In practice

Connect an editor to the mesh
A developer pastes the block from `npx @flashyos/mcp --print-config` into their MCP host, and their coding agent can heartbeat, read roadmap work and report shipped tasks as tools — with no integration code.
Give a no-code agent mesh actions
An MCP-speaking assistant with no FlashyOS SDK dependency gains the full reporting surface through the server, because the tools are the same actions the SDK exposes.

How it stays honest

The server releases on its own cadence: a version bump to packages/mcp on main fires its publish workflow, kept separate from the SDK so a break in one cannot stall the other. A drift test fails the build if the advertised tool list and the SDK surface disagree. The workflow builds the SDK first, because the MCP’s typed build reads the SDK’s built types.

.github/workflows/publish-mcp.yml ↗the workflow that keeps this current — read it, it hides nothing

Questions

How do I connect an MCP client to FlashyOS?
Run `npx @flashyos/mcp --print-config` to get a config block with your values filled in, paste it into your MCP host, and the mesh actions appear as tools. There is no code to write.
Does the MCP server need new credentials?
No. It uses the same three environment variables as @flashyos/agent — org id, agent name and agent token — and introduces no new secrets, because it is a thin wrapper over the same SDK.
Can the MCP tools drift from the SDK?
No. A build-failing drift test keeps the server’s tool list in lockstep with @flashyos/agent, so the MCP surface can never advertise a capability the SDK does not actually ship.

The licence

Apache-2.0, read from the package’s own manifest. Embed it in anything, including closed software — that is what makes a spec adoptable and a verifier worth running. FlashyOS’s server side is AGPL-3.0-only instead, and a test in the monorepo asserts the direction between them: AGPL code may consume this, this may never consume AGPL code.

Keep reading

Connect over MCP
Also in connect
@flashyos/agent@flashyos/create-mesh-agent@flashyos/create-mesh-node@flashyos/page@flashyos/eslint-config@flashyos/llm-gateway@flashyos/wallet-wdk@flashyos/signer@flashyos/wdk