Cursor

Cursor can run workonward-mcp as a local stdio server from mcp.json. This is the recommended setup for editor workflows because the PING8 API key stays on your machine.

Reference: Cursor MCP documentation (opens in a new tab).

Install Locally

cd SDK/mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
workonward-mcp --check

Choose Config Scope

Scope	Path	Use when
Global	`~/.cursor/mcp.json`	You want PING8 tools in all Cursor workspaces
Project	`.cursor/mcp.json`	You want the config tied to one repo

Do not commit real API keys in project config. Use environment variables or local-only files for secrets.

Stdio Config

{
  "mcpServers": {
    "workonward": {
      "command": "/absolute/path/to/SDK/mcp/.venv/bin/python",
      "args": ["-m", "workonward_mcp"],
      "env": {
        "WORKONWARD_API_KEY": "YOUR_API_KEY",
        "WORKONWARD_BASE_URL": "https://mail.gitdate.ink",
        "WORKONWARD_MCP_RECIPIENT_ALLOWLIST": "@gitdate\\.ink$|@actualintelligence\\.ink$",
        "WORKONWARD_MCP_DRY_RUN": "1",
        "WORKONWARD_MCP_AUDIT_LOG_PATH": "/tmp/workonward-mcp-audit.jsonl"
      }
    }
  }
}

If your Cursor setup supports environment interpolation, keep the key outside the JSON:

{
  "mcpServers": {
    "workonward": {
      "command": "/absolute/path/to/SDK/mcp/.venv/bin/python",
      "args": ["-m", "workonward_mcp"],
      "env": {
        "WORKONWARD_API_KEY": "${env:WORKONWARD_API_KEY}",
        "WORKONWARD_MCP_RECIPIENT_ALLOWLIST": "@gitdate\\.ink$",
        "WORKONWARD_MCP_DRY_RUN": "1"
      }
    }
  }
}

Optional Remote HTTP Config

Cursor also supports remote MCP servers. Use this only if you have deployed workonward-mcp behind HTTPS with OAuth:

{
  "mcpServers": {
    "workonward": {
      "url": "https://mcp.gitdate.ink/mcp"
    }
  }
}

For local development, prefer stdio.

Verify

Restart Cursor or refresh MCP servers.
Open the Agent tools list.
Confirm workonward appears.
Ask the agent to validate recipients before sending.

Safe prompt:

Use only the workonward MCP server. Validate ["person@gitdate.ink", "bad-address"], then preview a send to person@gitdate.ink. Do not send.

Troubleshooting

Symptom	Check
Server not listed	Confirm whether Cursor is reading global or project `mcp.json`
Python module missing	Use the absolute virtualenv Python path
Tool calls need approval	Approve only validation and preview until dry-run testing is complete
Key accidentally committed	Rotate the PING8 API key and remove it from git history before sharing

Claude.ai Web ChatGPT