@palveron/mcp-server
v1.0.0
Published
Palveron MCP Server — Model Context Protocol integration for AI Governance. Enables LLM tools to enforce governance policies in real time.
Downloads
133
Maintainers
Readme
Run every tool call your MCP-capable client makes — Claude Code, Cursor, any other MCP host — through the Palveron AI Governance Gateway. Policies enforced, PII masked, decisions logged, audit trails anchored.
- Drop-in MCP server — one binary, configure your MCP host, you're done
- Real-time policy enforcement — block, modify, or allow each tool call before it executes
- Audit trail per tool call — trace IDs flow back to the Palveron dashboard
- Built on
@palveron/sdk— retry, circuit breaker, typed errors out of the box
Installation
npm install -g @palveron/mcp-server
# or use directly via npx
npx @palveron/mcp-serverQuick Start
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-mcpTools exposed via MCP
| Tool | Purpose |
|------|---------|
| palveron_verify | Gate any prompt before the host sends it to the model. Returns ALLOWED / BLOCKED / MODIFIED plus the sanitized prompt. |
| palveron_check_tool_call | Gate a specific tool invocation against the agent's capability model. |
| palveron_list_policies | List the project's active guardrails 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_… / pv_test_…) |
| PALVERON_BASE_URL | no | Override the gateway endpoint (default: https://gateway.palveron.com) |
| PALVERON_TIMEOUT_MS | no | Request timeout in ms (default: 30000) |
Requirements
- Node.js 18 or newer
- An MCP-capable client (Claude Code 0.4+, Cursor, etc.)
Links
- Documentation — docs.palveron.com/integrations/mcp
- Dashboard — palveron.com
- Support — [email protected]
- GitHub — palveron/mcp-server
- Changelog — CHANGELOG.md
License
MIT — Copyright © 2026 Palveron.
