Psychosynth MCP Server

by 3esignio.github.3esign/psychosynthv0.1.3

MCP server for the Psychosynth synthetic psychometric data marketplace — discover the catalog, fetch free deterministic previews, get x402 price quotes, and run paid queries with your own wallet.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Psychosynth MCP server

claude mcp add psychosynth -e BUYER_PRIVATE_KEY='<buyer-private-key>' -- npx -y psychosynth-mcp

{
  "mcpServers": {
    "psychosynth": {
      "command": "npx",
      "args": [
        "-y",
        "psychosynth-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<buyer-private-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "psychosynth": {
      "command": "npx",
      "args": [
        "-y",
        "psychosynth-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<buyer-private-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "psychosynth": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "psychosynth-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<buyer-private-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "psychosynth": {
      "command": "npx",
      "args": [
        "-y",
        "psychosynth-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<buyer-private-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PSYCHOSYNTH_API_URL	—	—	Base URL of the Psychosynth API deployment (e.g. https://your-app.vercel.app). Defaults to http://localhost:3000 for local development.
BUYER_PRIVATE_KEY	—	yes	Base (EVM) wallet private key used to pay for queries via x402. Omit to use only the free catalog, preview, and quote tools.
BASE_RPC_URL	—	—	Optional custom Base mainnet RPC endpoint. Defaults to https://mainnet.base.org.

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-23 · 3mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-22 · 3mo ago · official registry · v0.1.3

FAQ

›How do I install the Psychosynth MCP server in Claude Code?

Run: claude mcp add psychosynth -e BUYER_PRIVATE_KEY='<buyer-private-key>' -- npx -y psychosynth-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Psychosynth require an API key?

Yes. It expects BUYER_PRIVATE_KEY, of which 1 is a secret.

›Can I use Psychosynth as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Psychosynth in the official MCP registry?

Yes, as io.github.3esign/psychosynth.