Skip to main content
Glama
creedspace-mcp

creedspace-mcp

Official
by Creed-Space

creedspace-mcp-server

Universal MCP server for Creed Space - AI safety guardrails in 10 seconds.

npm version License: MIT

Available in

The server is published to the canonical MCP catalogues, so registry-aware clients can discover and install it directly — or use any command in Quick Start below.

  • npm — @creedspace/mcp-server, the package every install path resolves to.

  • Official MCP Registry — io.github.Creed-Space/creedspace-mcp-server.

  • GitHub — source, issues, and the server.json manifest.

  • Smithery — nell/creedspace, a gateway-fronted Streamable HTTP endpoint.

Also rolling out across the wider MCP ecosystem: mcp.directory, mcpservers.org, PulseMCP (via the registry ingest), and mcp.so.

Related MCP server: repo-seatbelt

Quick Start

# STDIO transport (Claude Desktop, OpenAI Codex)
npx @creedspace/mcp-server --persona ambassador

# HTTP transport (OpenAI Agents SDK)
npx @creedspace/mcp-server --transport http --port 3100

# Test API connection
npx @creedspace/mcp-server test

What is Creed Space?

Creed Space provides personalized AI safety guardrails through Constitutional AI personas. Each persona enforces specific values and behaviors, ensuring AI assistants operate within defined ethical boundaries.

  • 🛡️ Reduces harmful AI outputs via constitutional evaluation of every response

  • 🎯 Refuses dangerous prompts according to the active persona's values

  • 🚀 10-second setup with any MCP-compatible AI

Available Personas

Persona

Icon

Purpose

Ambassador

🤝

Professional communication

Nanny

👶

Child-safe interactions

Sentinel

🛡️

Privacy and security focus

Godparent

🕊️

Religious and ethical guidance

Muse

🎨

Creative exploration

Anchor

⚓

Reality grounding

Installation

# No installation needed - just run!
npx @creedspace/mcp-server --persona ambassador

Option 2: Global Installation

npm install -g @creedspace/mcp-server
creedspace-mcp --persona ambassador

Option 3: Project Dependency

npm install @creedspace/mcp-server

Claude Desktop Integration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "creedspace": {
      "command": "npx",
      "args": ["@creedspace/mcp-server", "--persona", "ambassador"]
    }
  }
}

Then restart Claude Desktop to load the Creed Space guardrails.

Configuration

Environment Variables

# .env file
CREEDSPACE_API_URL=https://api.creed.space
CREEDSPACE_API_KEY=your-api-key-here  # Optional
CREEDSPACE_DEFAULT_PERSONA=ambassador

Command Line Options

creedspace-mcp \
  --persona ambassador \
  --url https://api.creed.space \
  --api-key YOUR_KEY \
  --cache-ttl 300000 \
  --offline

# HTTP Transport Options
creedspace-mcp \
  --transport http \
  --port 3100 \
  --host localhost \
  --api-key YOUR_KEY \
  --cors \
  --cors-origin http://localhost:3000 \
  --stateless

Transport Types

Transport

Use Case

Platforms

stdio (default)

Local subprocess communication

Claude Desktop, OpenAI Codex

http

HTTP server for remote/local connections

OpenAI Agents SDK, custom integrations

Configuration File

# Generate example configs
creedspace-mcp --generate-config

# Use config file
creedspace-mcp --config creedspace.json

Available MCP Tools

The server provides 16 tools to MCP clients:

Constitutions

  • get_constitution - Get the merged constitution for a persona

  • get_constitution_by_id - Get a specific constitution by ID

  • search_constitutions - Search the constitution library

Personas

  • list_personas - List all available personas

  • set_persona - Switch the active persona

  • get_active_persona - Get the currently active persona

  • get_uvc_qualities - Get desired/disliked/never qualities

  • get_system_prompt - Get a complete persona system prompt

  • preview_export - Preview the export configuration

Runtime guardrails

  • adjudicate - Get a policy decision kernel for a request

  • attest_response - Validate a response against the active creed

  • get_anchor - Get a compact non-negotiable-rules anchor

  • heartbeat - Periodic re-anchoring to prevent context drift

  • clear_cache - Clear the local cache

Multi-scale value handshake

  • perform_multi_scale_handshake - N-party value handshake across micro/meso/macro scales

  • get_scale_attestation - Get an attestation record with hash chain

Programmatic Usage

import { CreedSpaceMCPServer } from '@creedspace/mcp-server';

// Start server programmatically
const server = new CreedSpaceMCPServer({
  persona: 'ambassador',
  apiUrl: 'https://api.creed.space',
  cacheEnabled: true
});

await server.start();
// Use the API client directly
import { CreedSpaceClient } from '@creedspace/mcp-server';

const client = new CreedSpaceClient();
const personas = await client.getPersonas();
const constitution = await client.getMergedConstitution('ambassador');

Platform Integration Examples

OpenAI Agents SDK (HTTP Transport)

from agents import Agent
from agents.mcp import MCPServerStreamableHttp

# Start the server first:
# npx @creedspace/mcp-server --transport http --port 3100

server = MCPServerStreamableHttp(
    url="http://localhost:3100/mcp",
    name="creedspace"
)

agent = Agent(
    name="safe-agent",
    tools=[server.get_tools()]
)

# The agent now has access to Creed Space safety tools

OpenAI Codex (STDIO Transport)

Add to ~/.codex/config.toml:

[mcp_servers.creedspace]
command = "npx"
args = ["@creedspace/mcp-server", "--persona", "ambassador"]

[mcp_servers.creedspace.env]
CREEDSPACE_API_URL = "https://api.creed.space"

VS Code / Cursor

{
  "mcp.servers": {
    "creedspace": {
      "command": "npx",
      "args": ["@creedspace/mcp-server", "--persona", "ambassador"]
    }
  }
}

Continue.dev

{
  "models": [{
    "provider": "openai",
    "mcp_servers": [{
      "command": "npx",
      "args": ["@creedspace/mcp-server"]
    }]
  }]
}

LangChain

from langchain.tools import MCPTool

creedspace = MCPTool(
    command="npx",
    args=["@creedspace/mcp-server", "--persona", "ambassador"]
)

Testing

# Test API connection
npx @creedspace/mcp-server test

# Test with specific URL
npx @creedspace/mcp-server test --url http://localhost:8000

Offline Mode

The server includes intelligent caching for offline usage:

# Enable offline mode with cached data
creedspace-mcp --offline --persona ambassador

Development

# Clone the repository
git clone https://github.com/Creed-Space/creedspace-mcp-server.git
cd creedspace-mcp-server

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

API Documentation

Full API documentation available at https://api.creed.space/api-docs

Support

License

MIT © Nell Watson


Building critical AI safety infrastructure that shapes autonomous AI-human value interaction.

Available Tools

16 tools
adjudicateC

Get a policy decision kernel for a user request based on active constitutions and persona

Inputs: question (required), context, persona_id. Returns: Policy decision kernel returned by the Creed Space PDP

attest_responseA
Read-only

Validate a response against the active creed to check for violations and ensure attestation

Inputs: response (required), persona_id. Returns: status, warnings, creedHash, violations, +1 more

clear_cacheA
Idempotent

Clear the local cache to force fresh data from the API

Inputs: no named parameters. Returns: cleared, message

get_active_personaA
Read-only

Get the currently active persona for this session

Inputs: no named parameters. Returns: id, icon, name, description

get_anchorA
Read-only

Get a compact anchor (1-2KB) with top 10 non-negotiable rules and creed hash for quick context reinforcement

Inputs: max_length, persona_id. Returns: anchor, persona, maxLength, personaId, +2 more

get_constitutionA
Read-only

Get the merged constitution for a specific persona, including all active rules and UVC qualities

Inputs: persona_id. Returns: icon, content, persona, uvcToken, +2 more

get_constitution_by_idA
Read-only

Get a specific constitution by its ID

Inputs: constitution_id (required). Returns: id, name, content, personaId, +2 more

get_scale_attestationA
Read-only

Get attestation record with hash chain for a specific scale and entity

Inputs: scale (required), entity_id (required), include_chain. Returns: Attestation record, attestation chain, or null-attestation placeholder

get_system_promptA
Read-only

Get a complete system prompt for a persona including constitution and UVC qualities

Inputs: persona_id. Returns: personaId, systemPrompt, creedAttestation

get_uvc_qualitiesA
Read-only

Get the desired, disliked, and never qualities for a persona from the UVC system

Inputs: persona_id. Returns: personaId, qualities, configured

heartbeatB
Read-only

Periodic re-anchoring to prevent context drift - returns mini-anchor every 10 messages

Inputs: force, persona_id, message_count. Returns: text, persona, anchored, personaId, +1 more

list_personasA
Read-only

List all available AI personas with their descriptions and current status

Inputs: no named parameters. Returns: current, available

perform_multi_scale_handshakeB

Perform N-party value handshake across micro/meso/macro scales with anti-collusion and hierarchical budgets

Inputs: parties (required), invariants. Returns: Handshake result returned by the Creed Space safety stack

preview_exportC

Preview the export configuration for Claude Code or other AI tools

Inputs: persona_id, include_uvc, include_constitutions, include_system_prompt. Returns: preview, personaId, includeUvc, personaName, +3 more

search_constitutionsA
Read-only

Search constitutions by keyword or persona

Inputs: query, persona_id. Returns: query, persona, results, constitutions

set_personaA
Idempotent

Switch to a different AI persona for the current session

Inputs: persona_id (required). Returns: id, icon, name, message, +1 more

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 16 tools

    Disambiguation4/5

    Tools have distinct purposes, but several 'get' variants (constitution, qualities, system prompt, anchor) overlap conceptually. Descriptions clarify differences, so confusion is limited.

    Naming Consistency3/5

    Naming mixes verb_noun patterns (get_constitution, list_personas) with standalone verbs (adjudicate, heartbeat) and verbose compounds (perform_multi_scale_handshake). This inconsistency reduces predictability.

    Tool Count3/5

    At 16 tools, the count is slightly above the typical well-scoped range of 3-15. The domain is broad, but a few tools (e.g., get_constitution vs. get_constitution_by_id) could be consolidated.

    Completeness4/5

    The set covers core operations for personas, constitutions, and attestations, including retrieval, search, active persona selection, and validation. Missing create/update/delete may be acceptable depending on the intended use case.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Unified MCP safety server that detects prompt injection (75 patterns), scans LLM outputs for leaked secrets/PII, enforces API cost budgets, and creates signed audit trails. Zero ML dependencies, pure Python.
      17
      65 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for AI agent security guardrails. Provides input validation, prompt injection detection, PII redaction, output filtering, policy enforcement, rate limiting, and comprehensive audit logging.
      72 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Constitutional MCP server enforcing 13 Floors of governance for AI agents, providing tools for session anchoring, reasoning, safety critique, and audit logging.
      AGPL 3.0