@quiqsol/mcp

Connect QuiQSol to Claude, ChatGPT, Cursor and any AI agent.

This package gives you two things:

• quiqsol mcp: a local Model Context Protocol server over stdio, for apps that launch a command (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code).
• quiqsol: a command line for your terminal, scripts and agents, with JSON output.

Both run on the QuiQSol remote MCP server at https://api.quiqsol.com/mcp. Tools, permissions and safety rules live on the server, so this package stays small, has zero dependencies and never needs an update to gain new tools.

MIT licensed.

What your agent can do

Security model

• Scoped access. Every key and connection carries explicit scopes (crm:read, crm:write, helpdesk:read, helpdesk:write, inbox:read, inbox:send, invoices:read, invoices:write, invoices:send, projects:read, projects:write, forms:read, analytics:read). An agent only sees the tools its scopes allow.
• Your own permissions. An agent acts as the person who created the key or approved the connection, inside that person's role. It can never do more than they can in the app.
• Nothing reaches a customer without approval. Ticket replies, inbox replies and invoice sends return a preview first. They only go out when called again with confirm: true, which agents are instructed to do only after you approve.
• Untrusted content is labelled. Every result is wrapped as workspace data, with customer-written text marked as data, never instructions.
• No secrets in output. Tokens, hashes and keys are stripped from every result server-side.
• Revocable and audited. Revoke any key or connection in Settings > Developer Platform. Every call is listed in the API activity log there.

Get a key

In QuiQSol, open Settings > Developer Platform > AI agents, choose Create AI agent key, pick the scopes and copy the key (shown once).

Claude and ChatGPT do not need a key: add https://api.quiqsol.com/mcp as a connector and sign in with OAuth. See the setup guide.

Use with Claude Desktop, Cursor or any stdio MCP client

{
  "mcpServers": {
    "quiqsol": {
      "command": "npx",
      "args": ["-y", "@quiqsol/mcp", "mcp"],
      "env": { "QUIQSOL_API_KEY": "aur_live_..." }
    }
  }
}

Claude Desktop: Settings > Developer > Edit Config. Cursor: ~/.cursor/mcp.json or Settings > MCP.

Clients that support remote servers can skip the package and point straight at the server:

{
  "mcpServers": {
    "quiqsol": {
      "url": "https://api.quiqsol.com/mcp",
      "headers": { "Authorization": "Bearer aur_live_..." }
    }
  }
}

Claude Code:

claude mcp add --transport http quiqsol https://api.quiqsol.com/mcp

Use the CLI

npm install -g @quiqsol/mcp
quiqsol login
quiqsol whoami

quiqsol leads list --status NEW --limit 10
quiqsol leads create --first-name Ada --last-name Obi --email ada@example.com --source WEBSITE
quiqsol deals pipeline
quiqsol deals move 66f0c2aa66f0c2aa66f0c2aa "Proposal sent"
quiqsol ti

... [View full README on GitHub](https://github.com/asholamide/quiqsol-mcp#readme)