@truealter/mcp-alter-collective

@truealter/mcp-alter-collective

The Alter (collective) MCP server. Organisational intelligence layer for ALTER and any organisation running an Alter (collective) instance.

Part of the ALTER identity protocol.

What this is

A Model Context Protocol server exposing tools for organisational state. State lives in files (or proxies to a remote Alter (collective) instance); tools surface it to agents and editors that speak MCP.

The current tool surface is 15 tools:

• alter_brief - generate morning/weekly/monthly brief
• alter_signals - list/get signals (filtered)
• alter_decisions - search and read the Strategic Decisions Register
• alter_drafts - list/get/approve/reject draft responses
• alter_metrics - agent health metrics
• alter_roster - list active agents and trust tiers
• alter_config - get/set routing rules and thresholds
• alter_ingest - ingest a new signal from any adapter
• alter_compliance - compliance and legal-doc status
• alter_dev_state - shipped vs not-wired vs not-built code state
• alter_mcp_readiness - eight-milestone launch readiness view
• alter_token_usage - model token spend by principal and window
• alter_absence_brief - standup-as-category deep-dive for an absent principal
• alter_escalations - get urgent items requiring human attention
• alter_roster_principals - list principal ~handle identities (HTTP mode only)

Install

The intended path is via the alter CLI:

npm i -g @truealter/cli
alter login
alter pair org-alter

The CLI runs the server under the correct cap-token and identity binding, so each principal sees the surface their ~handle is authorised to see.

Direct npx invocation is supported for advanced agents:

npx @truealter/mcp-alter-collective

Direct invocation requires environment configuration. See MIGRATION.md for the full env-var reference.

Modes

• local - file-based state from ${ALTER_DATA_DIR} (default).
• http - proxy to a remote Alter (collective) instance via cap-token.

Mode is selected with ORG_ALTER_HTTP_MODE.

Licence

Apache-2.0. See LICENSE.