Every way to plug Kelviq in

Ask a coding agent, call the SDKs, keep your pricing as code or hit the REST API. One catalog, one sandbox, the same keys everywhere.

AGENTS, MCP AND CLI

Ask your agent to set up billing

Tell your agent what to charge. It sets up your plans and usage limits through Kelviq’s MCP server or CLI, then hands you a checkout link.

Claude Code Adds the MCP server and five skills.
$/plugin marketplace add kelviq/agent-toolkit
$/plugin install kelviq@kelviq
MCP client Cursor, VS Code, Devin Desktop and more.
$npx -y @kelviq/mcp-server@latest
Skills The five Kelviq skills, for Cursor, Codex and 70+ other agents.
$npx skills add kelviq/agent-toolkit
CLI Pricing as code. In beta.
$npm install -g @kelviq/cli
Works withClaudeCodexCursorVS CodeDevin DesktopAntigravity
SDKS

Check access and report usage from your stack

Check what a customer can use, and report what they used.

SDK reference
npm install @kelviq/node-sdk
12345678910111213141516171819202122232425
            import { Kelviq, BEHAVIOUR_CHOICES } from '@kelviq/node-sdk';

const client = new Kelviq({
  accessToken: process.env.KELVIQ_SERVER_API_KEY,
  environment: process.env.KELVIQ_ENV, // 'sandbox' or 'production'
});

// Count one API call
await client.reporting.reportUsage({
  customerId: 'cust_123',
  featureId: 'api-calls',
  value: 1,
  behaviour: BEHAVIOUR_CHOICES.DELTA,
});

// Check what's left
const ent = await client.entitlements.getEntitlement({
  customerId: 'cust_123',
  featureId: 'api-calls',
});

if (!ent || (!ent.hasAccess && ent.hardLimit)) {
  // No access, or a hard limit was reached: block or ask the customer to upgrade
}
// Past a soft limit, let the call through: it's billed as overage
          
pip install kelviq-sdk
12345678910111213141516171819202122232425
            from kelviq_sdk import Kelviq

client = Kelviq.create_sync_client(
    access_token=KELVIQ_SANDBOX_SERVER_API_KEY,
    environment="sandbox",
)

# Count one API call
client.reporting.report_usage(
    customerId="cust_123",
    featureId="api-calls",
    value=1,
    behaviour="DELTA",
)

# Check what's left
ent = client.entitlements.get_entitlement(
    customerId="cust_123",
    featureId="api-calls",
)

if not ent or (not ent.hasAccess and ent.hardLimit):
    # No access, or a hard limit was reached: block or ask the customer to upgrade
    ...
# Past a soft limit, let the call through: it's billed as overage
          
npm install @kelviq/react-sdk
12345678910111213141516171819
            import { KelviqProvider, ShowWhenBooleanEntitled } from "@kelviq/react-sdk";

function App() {
  return (
    <KelviqProvider
      accessToken={process.env.NEXT_PUBLIC_KELVIQ_CLIENT_API_KEY!}
      customerId="cust_123"
      environment="sandbox" // omit in production
    >
      <ShowWhenBooleanEntitled
        featureId="priority-support"
        loadingComponent={<p>Checking…</p>}
        fallback={<a href="/upgrade">Upgrade for priority support</a>}
      >
        <ContactSupportButton />
      </ShowWhenBooleanEntitled>
    </KelviqProvider>
  );
}
          
npm install @kelviq/js-sdk
123456789101112131415161718192021
            import kelviqSDK from '@kelviq/js-sdk';

// Initialize the SDK (fetches entitlements automatically)
const kq = kelviqSDK({
  customerId: "your-customer-id",
  accessToken: "your-access-token",
});

// Wait for the initial fetch to complete
await kq.ready();

// Check if user has access to a feature
if (kq.hasAccess('premium-features')) {
  console.log("User has access to premium features!");
}

// Get specific entitlement details
const emailQuota = kq.getEntitlement('email-sends');
if (emailQuota && emailQuota.hasAccess) {
  console.log(`Emails remaining: ${emailQuota.remaining}`);
}
          
CLI

Pricing as code

Keep your catalog in one typed file, reviewed like any other code.

CLI overview
  1. npm install -g @kelviq/cli
    Needs Node.js 18 or newer
  2. kelviq login
    Paste and store a Server API key
  3. kelviq pull
    Write your remote catalog to kelviq.config.ts
  4. kelviq push --dry-run
    Print the diff and exit, never writes
  5. kelviq push --publish
    Apply, then publish the plans it changed
  6. kelviq promote
    Move the sandbox catalog to production
1
import { product, feature, plan } from '@kelviq/cli/config';
2
 
3
export const app = product({
4
  identifier: 'my-app',
5
  name: 'My App',
6
  taxCode: 'saas',
7
});
8
 
9
export const historyRetention = feature({
10
  identifier: 'history-retention',
11
  name: 'History retention (days)',
12
  type: 'CUSTOMIZABLE',
13
});
14
 
15
export const pro = plan({
16
  identifier: 'pro',
17
  name: 'Pro',
18
  product: 'my-app',
19
  entitlements: [{ feature: 'history-retention', value: 30 }],
20
});
REST API AND WEBHOOKS

One API behind all of it

Every tool on this page calls the same REST API.

API reference
22 events
signed, and verified in one SDK call
1 + 3
a first delivery and three automatic retries
30 days
of delivery logs, with a resend button
Start your
software monetization.

Global tax, billing, metering, and entitlements. Ship your revenue stack in one deploy.