Skip to main content
Glama
@palveron/mcp-server

@palveron/mcp-server

by palveron

⚡ Early access. Palveron is launching soon and access is currently invite-gated. This server is fully functional — you just need a pv_live_ key, which comes with an Early Access invite. Join the waitlist → palveron.com/early-access

Give your MCP-capable client — Claude Code, Cursor, any other MCP host — governance tools it can call before executing an action: policy verdicts, PII-masking results, and an audit trace for every check, all from the Palveron AI Governance Gateway.

  • Drop-in MCP server — one binary, configure your MCP host, you're done

  • Advisory governance verdicts — the gateway decides allow / mask / deny / hold; the agent (or your wrapping code) acts on the verdict

  • Audit trail per check — trace IDs flow back to the Palveron dashboard

  • Built on @palveron/sdk — retry, circuit breaker, typed errors out of the box

Advisory check vs. enforced governance — which one do you need?

This package is the advisory path. It cannot physically stop a tool call: it answers the question "is this allowed?", and the calling agent (or your code via check()/wrap()) is expected to honor the answer. That is by design — it works with any MCP host, needs no network topology change, and gives you verdicts plus audit traces immediately.

Enforced, non-bypassable governance for MCP tool calls is a different product surface: the Palveron remote MCP proxy. There you register the target MCP server in the Palveron dashboard and point your IDE at POST {gateway}/api/v1/mcp/proxy/{server_id} instead of the target — every tools/call then structurally passes through policy checks, approval holds, and drift detection before it can reach the target server. No cooperation from the agent required.

This package (@palveron/mcp-server)

Remote MCP proxy

Model

Voluntary pre-flight check

In-path enforcement

Can a call bypass it?

Yes — enforcement depends on the caller honoring the verdict

No — the proxy sits between client and target server

Setup

npx, one env var

Register the target server in the dashboard, point the IDE at the proxy URL

Use it when

You want verdicts + audit traces inside any MCP host, or wrap tool calls programmatically

You need governance that agents cannot skip

See the MCP setup guide for the enforced path.

Related MCP server: AgentGuard MCP Server

Installation

npm install -g @palveron/mcp-server
# or use directly via npx
npx @palveron/mcp-server

Quick Start

The pv_live_… key in the examples below requires an Early Access invite — request one here. Once you have a key, everything works out of the box.

Claude Code

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "palveron": {
      "command": "npx",
      "args": ["@palveron/mcp-server"],
      "env": {
        "PALVERON_API_KEY": "pv_live_xxx",
        "PALVERON_BASE_URL": "https://gateway.palveron.com"
      }
    }
  }
}

Other MCP hosts

Any MCP-capable host can launch the server via the palveron-mcp binary:

PALVERON_API_KEY=pv_live_xxx palveron-mcp

Tools exposed via MCP

Tool

Purpose

palveron_check

Check a tool call against governance policies before execution. Returns the decision (PASSED, BLOCKED, MODIFIED/REDACTED/ANONYMIZED with the sanitized input, PENDING_APPROVAL, …), whether the call may proceed, findings, and the audit trace ID.

palveron_status

Governance status and diagnostics — gateway connectivity, circuit-breaker state, configured local lists.

palveron_policy_list

List the project's active policies so the host can explain its decisions.

Configuration

The server reads its configuration from environment variables. The MCP host sets them; you never put secrets in code.

Variable

Required

Description

PALVERON_API_KEY

yes

API key (pv_live_…) — comes with an Early Access invite

PALVERON_BASE_URL

no

Override the gateway endpoint (default: https://gateway.palveron.com)

PALVERON_FAIL_OPEN

no

true = allow tool calls when the gateway is unreachable (default: false, fail-closed)

PALVERON_LOG_LEVEL

no

debug / info / warn / error / silent (default: info)

PALVERON_ALWAYS_BLOCK

no

Comma-separated tool names that are always denied locally, without a gateway call

PALVERON_ALWAYS_ALLOW

no

Comma-separated tool names that always pass locally, without a gateway call

Requirements

  • Node.js 18 or newer

  • An MCP-capable client (Claude Code 0.4+, Cursor, etc.)

License

MIT — Copyright © 2026 Palveron.

Available Tools

3 tools
palveron_checkA

Verify a tool call against PALVERON governance policies before execution. Returns whether the action is allowed, blocked, or modified (with PII redacted). Every check creates an immutable audit trace.

Inputs: tool (required), input (required), agent_id, session_id.

palveron_policy_listA

List active governance policies for the current project. Shows policy names, enforcement actions, and content type scopes.

Inputs: environment.

palveron_statusA

Get PALVERON governance status and diagnostics. Shows connection state, circuit breaker status, configured policies, and gateway health.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct purpose: palveron_check verifies a single action, palveron_status provides system diagnostics, and palveron_policy_list lists policies. There is no ambiguity or overlap between them.

    Naming Consistency4/5

    All tools share the consistent palveron_ prefix and snake_case format, but the second word is a mix of verb (check) and nouns (status, policy_list). Minor deviation from a strict verb_noun pattern.

    Tool Count5/5

    Three tools is well-scoped for a governance checker: one to perform checks, one for status, and one for policy listing. No tools feel redundant or missing.

    Completeness5/5

    The domain is governance policy enforcement, and the set covers the core operations: enforcing a policy (check), understanding system state (status), and discovering applicable policies (list). No obvious gaps for the stated purpose.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Policy enforcement gateway for MCP tool calls, evaluating every tool invocation against declarative YAML policies (allow/deny/escalate-to-human), generating cryptographic hash-chained audit receipts, and including built-in content safety scanning.
      2
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Provides a secure MCP boundary for AI agents, intercepting and validating tool calls, redacting secrets, and requiring human approval for sensitive actions with a tamper-evident audit trail.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides a governance layer for MCP servers, enforcing policy-based allow/deny/approval rules, requiring human approval for risky calls, and recording an auditable trail of every AI agent tool call.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents and MCP clients to route every tool call through configurable rules that allow, block, or hold risky actions for human approval, while recording decisions in a tamper-evident audit trail.
      12
      268 PyPI
      19
      Apache 2.0