Verimand MCP Authority Server

Verimand MCP Authority Server

MCP exposes capability. VAGP governs authority.

The Verimand MCP Authority Server gives MCP-compatible clients agent-native access to verifiable VAGP authority. It exposes a small stdio tool surface for asking whether a trusted registered agent currently has authority, inspecting trusted authority state, and verifying VAGP execution permits.

Tool availability does not itself grant authority. This server is not yet the enforcement gateway for protected tool execution.

Package identity

• npm package: @verimand/mcp-authority-server
• MCP Registry server name: dev.verimand/mcp-authority-server
• Current version: 0.1.0
• Runtime: Node.js 22 or newer
• MCP SDK/runtime: @modelcontextprotocol/server 2.0.0, implementing the MCP 2026-07-28 spec with stdio legacy compatibility

Tools

• verimand.resolve resolves whether a trusted registered agent is authorized for an action and returns a VAGP execution permit only when authority is confirmed.
• verimand.explain explains deterministic authority decision or permit-derived data. It is informational only.
• verimand.get_authority returns bounded authority relevant to an agent/action.
• verimand.get_mandate retrieves server-side trusted mandate metadata.
• verimand.get_agent_dna returns server-side trusted Agent DNA state and fingerprint information.
• verimand.verify_permit verifies a VAGP execution permit against current authority evidence.

Install and start

After publication, a local MCP client can start the server with:

npx -y @verimand/mcp-authority-server@0.1.0

When running from this repository before publication:

pnpm --filter @verimand/mcp-authority-server build
node apps/mcp-authority-server/dist/stdio.js

The process speaks MCP over stdio. stdout is reserved for MCP protocol messages; diagnostics go to stderr.

MCP client configuration example

{
  "mcpServers": {
    "verimand-authority": {
      "command": "npx",
      "args": ["-y", "@verimand/mcp-authority-server@0.1.0"]
    }
  }
}

Do not place secrets, mandates, Agent DNA, revocation state or trusted context in agent-controlled MCP tool arguments. Production Verimand connection material must be supplied by the operator-controlled server environment, not by the agent using the MCP client.

First resolve example

{
  "name": "verimand.resolve",
  "arguments": {
    "agentId": "agent:demo-support",
    "action": "ticket.read",
    "resourceId": "ticket:123",
    "requestId": "req-demo-1"
  }
}

Expected structured content contains a deterministic authority decision, reason codes, selected mandate/path data and a permit only when VAGP resolves AUTHORITY_CONFIRMED.

Security and trust boundary

All MCP input is untrusted. The server accepts only small closed tool arguments and maps them to server-side trusted VAGP state. An MCP caller cannot self-declare trusted identity, Agent DNA, mandates, attestations, revocation state or trusted context.

The MCP server delegates authority semantics to VAGP 0.3 authority services. It does not execute protected business actions and does not replace an enforcement gateway. Protected tool execution remains outside this package.

VAGP relationship

VAGP 0.3 is the public authority protocol: https://github.com/verimand/vagp. This MCP server is a Verimand interface for authority inspection and permit verification over MCP.

Distribution status

MCP-DIST-01.1 prepares a self-contained CLI package for public npm distribution. The Verimand VAGP authority runtime required by this MCP server is bundled into dist/stdio.js; the installed package has no runtime dependency on unpublished @verimand/* workspace packages.

Development validation

pnpm --filter @verimand/mcp-authority-server build
pnpm --filter @verimand/mcp-authority-server smoke:stdio
pnpm vitest run tests/conformance/mcp-authority-server.test.ts

Support and security reporting

Report security issues to verimand.dev@gmail.com.