QuiQSol

@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 tickets list --status OPEN --mine quiqsol tickets reply 66f0c2aa66f0c2aa66f0c2aa --body "Your refund was processed today." quiqsol inbox list --channel whatsapp --unread quiqsol invoices create --contact-id 66f0c2aa66f0c2aa66f0c2aa --item "Website design:1:450000" --due-date 2026-11-30 quiqsol invoices send 66f0c2aa66f0c2aa66f0c2aa quiqsol analytics overview --days 30

Any tool, by name:

quiqsol tools

quiqsol call crm_list_deals '{"stage":"Negotiation","limit":5}'

Output is JSON on stdout (pretty in a terminal, compact when piped). Commands that reach a customer show a preview and ask before sending; in scripts they print the preview and exit with code 3 unless you pass --yes.

Configuration: QUIQSOL_API_KEY and QUIQSOL_API_URL override the saved login in ~/.config/quiqsol/config.json (written with owner-only permissions).

Use from code

const { QuiqsolClient } = require('@quiqsol/mcp');

const quiqsol = new QuiqsolClient({ apiKey: process.env.QUIQSOL_API_KEY }); const { data } = await quiqsol.callTool('crm_list_leads', { status: 'NEW', limit: 5 });

Prefer plain HTTP? The same tools are available as REST at https://api.quiqsol.com/public/v1/agent (GET /tools, POST /tools/{name}).

Requirements

Node.js 18 or later.

License

MIT. The QuiQSol platform itself is a commercial service; this connector is open source so you can read exactly what runs on your machine.