{
  "markdown": "# creedspace-mcp-server\n\nUniversal MCP server for Creed Space - AI safety guardrails in 10 seconds.\n\n[![npm version](https://img.shields.io/npm/v/@creedspace/mcp-server.svg)](https://www.npmjs.com/package/@creedspace/mcp-server)\n[![smithery badge](https://smithery.ai/badge/nell/creedspace)](https://smithery.ai/server/nell/creedspace)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Available in\n\nThe 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](#quick-start) below.\n\n- **[npm](https://www.npmjs.com/package/@creedspace/mcp-server)** — `@creedspace/mcp-server`, the package every install path resolves to.\n- **[Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Creed-Space/creedspace-mcp-server)** — `io.github.Creed-Space/creedspace-mcp-server`.\n- **[GitHub](https://github.com/Creed-Space/creedspace-mcp-server)** — source, issues, and the `server.json` manifest.\n- **[Smithery](https://smithery.ai/server/nell/creedspace)** — `nell/creedspace`, a gateway-fronted Streamable HTTP endpoint.\n\nAlso rolling out across the wider MCP ecosystem: [mcp.directory](https://mcp.directory), [mcpservers.org](https://mcpservers.org), [PulseMCP](https://www.pulsemcp.com) (via the registry ingest), and [mcp.so](https://mcp.so).\n\n## Quick Start\n\n```bash\n# STDIO transport (Claude Desktop, OpenAI Codex)\nnpx @creedspace/mcp-server --persona ambassador\n\n# HTTP transport (OpenAI Agents SDK)\nnpx @creedspace/mcp-server --transport http --port 3100\n\n# Test API connection\nnpx @creedspace/mcp-server test\n```\n\n## What is Creed Space?\n\nCreed 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.\n\n- 🛡️ **Reduces harmful AI outputs** via constitutional evaluation of every response\n- 🎯 **Refuses dangerous prompts** according to the active persona's values\n- 🚀 **10-second setup** with any MCP-compatible AI\n\n## Available Personas\n\n| Persona | Icon | Purpose |\n|---------|------|---------|\n| Ambassador | 🤝 | Professional communication |\n| Nanny | 👶 | Child-safe interactions |\n| Sentinel | 🛡️ | Privacy and security focus |\n| Godparent | 🕊️ | Religious and ethical guidance |\n| Muse | 🎨 | Creative exploration |\n| Anchor | ⚓ | Reality grounding |\n\n## Installation\n\n### Option 1: Use with npx (Recommended)\n```bash\n# No installation needed - just run!\nnpx @creedspace/mcp-server --persona ambassador\n```\n\n### Option 2: Global Installation\n```bash\nnpm install -g @creedspace/mcp-server\ncreedspace-mcp --persona ambassador\n```\n\n### Option 3: Project Dependency\n```bash\nnpm install @creedspace/mcp-server\n```\n\n## Claude Desktop Integration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"creedspace\": {\n      \"command\": \"npx\",\n      \"args\": [\"@creedspace/mcp-server\", \"--persona\", \"ambassador\"]\n    }\n  }\n}\n```\n\nThen restart Claude Desktop to load the Creed Space guardrails.\n\n## Configuration\n\n### Environment Variables\n```bash\n# .env file\nCREEDSPACE_API_URL=https://api.creed.space\nCREEDSPACE_API_KEY=your-api-key-here  # Optional\nCREEDSPACE_DEFAULT_PERSONA=ambassador\n```\n\n### Command Line Options\n```bash\ncreedspace-mcp \\\n  --persona ambassador \\\n  --url https://api.creed.space \\\n  --api-key YOUR_KEY \\\n  --cache-ttl 300000 \\\n  --offline\n\n# HTTP Transport Options\ncreedspace-mcp \\\n  --transport http \\\n  --port 3100 \\\n  --host localhost \\\n  --api-key YOUR_KEY \\\n  --cors \\\n  --cors-origin http://localhost:3000 \\\n  --stateless\n```\n\n### Transport Types\n\n| Transport | Use Case | Platforms |\n|-----------|----------|-----------|\n| `stdio` (default) | Local subprocess communication | Claude Desktop, OpenAI Codex |\n| `http` | HTTP server for remote/local connections | OpenAI Agents SDK, custom integrations |\n\n### Configuration File\n```bash\n# Generate example configs\ncreedspace-mcp --generate-config\n\n# Use config file\ncreedspace-mcp --config creedspace.json\n```\n\n## Available MCP Tools\n\nThe server provides 16 tools to MCP clients:\n\n**Constitutions**\n- `get_constitution` - Get the merged constitution for a persona\n- `get_constitution_by_id` - Get a specific constitution by ID\n- `search_constitutions` - Search the constitution library\n\n**Personas**\n- `list_personas` - List all available personas\n- `set_persona` - Switch the active persona\n- `get_active_persona` - Get the currently active persona\n- `get_uvc_qualities` - Get desired/disliked/never qualities\n- `get_system_prompt` - Get a complete persona system prompt\n- `preview_export` - Preview the export configuration\n\n**Runtime guardrails**\n- `adjudicate` - Get a policy decision kernel for a request\n- `attest_response` - Validate a response against the active creed\n- `get_anchor` - Get a compact non-negotiable-rules anchor\n- `heartbeat` - Periodic re-anchoring to prevent context drift\n- `clear_cache` - Clear the local cache\n\n**Multi-scale value handshake**\n- `perform_multi_scale_handshake` - N-party value handshake across micro/meso/macro scales\n- `get_scale_attestation` - Get an attestation record with hash chain\n\n## Programmatic Usage\n\n```javascript\nimport { CreedSpaceMCPServer } from '@creedspace/mcp-server';\n\n// Start server programmatically\nconst server = new CreedSpaceMCPServer({\n  persona: 'ambassador',\n  apiUrl: 'https://api.creed.space',\n  cacheEnabled: true\n});\n\nawait server.start();\n```\n\n```javascript\n// Use the API client directly\nimport { CreedSpaceClient } from '@creedspace/mcp-server';\n\nconst client = new CreedSpaceClient();\nconst personas = await client.getPersonas();\nconst constitution = await client.getMergedConstitution('ambassador');\n```\n\n## Platform Integration Examples\n\n### OpenAI Agents SDK (HTTP Transport)\n\n```python\nfrom agents import Agent\nfrom agents.mcp import MCPServerStreamableHttp\n\n# Start the server first:\n# npx @creedspace/mcp-server --transport http --port 3100\n\nserver = MCPServerStreamableHttp(\n    url=\"http://localhost:3100/mcp\",\n    name=\"creedspace\"\n)\n\nagent = Agent(\n    name=\"safe-agent\",\n    tools=[server.get_tools()]\n)\n\n# The agent now has access to Creed Space safety tools\n```\n\n### OpenAI Codex (STDIO Transport)\n\nAdd to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.creedspace]\ncommand = \"npx\"\nargs = [\"@creedspace/mcp-server\", \"--persona\", \"ambassador\"]\n\n[mcp_servers.creedspace.env]\nCREEDSPACE_API_URL = \"https://api.creed.space\"\n```\n\n### VS Code / Cursor\n```json\n{\n  \"mcp.servers\": {\n    \"creedspace\": {\n      \"command\": \"npx\",\n      \"args\": [\"@creedspace/mcp-server\", \"--persona\", \"ambassador\"]\n    }\n  }\n}\n```\n\n### Continue.dev\n```json\n{\n  \"models\": [{\n    \"provider\": \"openai\",\n    \"mcp_servers\": [{\n      \"command\": \"npx\",\n      \"args\": [\"@creedspace/mcp-server\"]\n    }]\n  }]\n}\n```\n\n### LangChain\n```python\nfrom langchain.tools import MCPTool\n\ncreedspace = MCPTool(\n    command=\"npx\",\n    args=[\"@creedspace/mcp-server\", \"--persona\", \"ambassador\"]\n)\n```\n\n## Testing\n\n```bash\n# Test API connection\nnpx @creedspace/mcp-server test\n\n# Test with specific URL\nnpx @creedspace/mcp-server test --url http://localhost:8000\n```\n\n## Offline Mode\n\nThe server includes intelligent caching for offline usage:\n\n```bash\n# Enable offline mode with cached data\ncreedspace-mcp --offline --persona ambassador\n```\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/Creed-Space/creedspace-mcp-server.git\ncd creedspace-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build TypeScript\nnpm run build\n\n# Run in development mode\nnpm run dev\n\n# Run tests\nnpm test\n```\n\n## API Documentation\n\nFull API documentation available at [https://api.creed.space/api-docs](https://api.creed.space/api-docs)\n\n## Support\n\n- 🌐 Website: [https://www.creed.space](https://www.creed.space)\n- 📧 Email: support@creed.space\n- 🐛 Issues: [GitHub Issues](https://github.com/Creed-Space/creedspace-mcp-server/issues)\n- 💬 Discord: [Join our community](https://discord.gg/creedspace)\n\n## License\n\nMIT © [Nell Watson](https://github.com/nellwatson)\n\n---\n\n*Building critical AI safety infrastructure that shapes autonomous AI-human value interaction.*\n",
  "bytes": 8257,
  "sha": "ebe290d92bd93ad66148a03c1cb70a128285b8d94830a18b88e255c31eee57a1",
  "repo_slug": "creed-space/creedspace-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_creed_space_creedspace_mcp_ser_9fdc69eb/readme"
}