@maccards/mcp
v0.3.10
Published
Model Context Protocol server for makcards.online — metaphor association cards for self-reflection. Hosted at mcp.makcards.online + mcp.journalingapp.app and runnable locally via `npx @maccards/mcp`.
Downloads
3,066
Maintainers
Readme
@maccards/mcp
Model Context Protocol server for makcards.online — metaphor association cards for self-reflection, journaling and group facilitation.
This package powers two surfaces:
- Hosted —
https://mcp.makcards.online/v1(and a dual-brand mirror athttps://mcp.journalingapp.app/v1). Streamable HTTP transport, used by Claude.ai, Claude Desktop in HTTP mode, and ChatGPT Apps. - Local stdio —
npx @maccards/mcpreads JSON-RPC over stdin/stdout. Used by Claude Desktop, Claude Code, Cursor with a local config block. The user's API key never leaves the machine.
Both modes share one codebase; only the entry point differs.
Status
Phase: EP-043B (in development). Tools, transports, and CI wiring are landing task by task — see tasks/EP-043B-mcp-servers.yaml in the makcards-online monorepo.
Requirements
A mk_live_* API key from app.makcards.online → Profile → AI access. Free tier: 10 draws per minute. Premium: 120.
Use locally (preview)
npx @maccards/mcpReads MAKCARDS_API_KEY from env. Add to Claude Desktop config:
{
"mcpServers": {
"makcards": {
"command": "npx",
"args": ["-y", "@maccards/mcp"],
"env": { "MAKCARDS_API_KEY": "mk_live_..." }
}
}
}Use hosted
Point your MCP client at https://mcp.makcards.online/v1 with header Authorization: Bearer mk_live_....
Links
- Canonical site: makcards.online
- For AI integrators: makcards.online/for-ai
- Full REST spec: openapi.json
- AI-safe subset: openapi.ai.json
- Terms: makcards.online/terms
- Privacy: makcards.online/privacy
License
MIT
