Sanka MCP

Connect Claude Code, ChatGPT Codex, and other AI clients to Sanka with MCP.

Last updated: July 2, 2026

Overview

The Sanka MCP server lets Claude Code, ChatGPT Codex, and other AI clients use Sanka as an AI employee for business workflows. They can safely read and update workspace business data with natural language. With MCP, your agent can:
  • inspect, create, and update companies, contacts, orders, and invoices
  • review approval requests and approval rules
  • preview and run workflows
  • inspect logs and workflow results
Use the hosted endpoint:
Text
https://mcp.sanka.com/mcp
Use mcp-remote so the client can complete browser-based OAuth against the hosted server instead of pasting an API key into the config.

Example config (ChatGPT Codex / Claude Code style)

JSON
{
  "mcpServers": {
    "sanka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.sanka.com/mcp",
        "--resource",
        "https://mcp.sanka.com/mcp"
      ]
    }
  }
}
On first use, the client opens a browser window for sign-in and consent. mcp-remote stores the resulting tokens locally in ~/.mcp-auth.

Local MCP server (alternative)

If you prefer local execution:
Bash
npx sanka-sdk mcp --api-key sk_xxx
Use this when you need custom local networking, debugging, or controlled runtime environments.

Core MCP tools

Common tools include:
  • create_deal
  • list_deals
  • update_deal
  • create_contact
  • create_invoice
  • list_incentives
  • create_incentive_plan
  • calculate_incentives
  • generate_incentive_payment_notice
  • send_outreach
Tool availability can expand over time.

Security and operations

  • Keep agent scope minimal (least privilege).
  • Review the requested OAuth scopes during setup.
  • Clear stale local auth state from ~/.mcp-auth if re-authentication gets stuck.
  • Log critical mutations and review agent-triggered changes.

Suggested prompts

  • "List orders created this month."
  • "Show invoices that have not been sent yet."
  • "Review approval requests that are waiting for action."