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.
>
kelviqconnection_checksandbox · connected
kelviqproduct_createAcme AI
kelviqfeature_createai-tokens · metered
kelviqplan_createPro · $29.00 / month
kelviqplan_entitlements_addai-tokens · 1,000,000 / month
kelviqplan_publishPro · published
kelviqcheckout_create_sessioncheckout link ready
Done. Pro is published in sandbox with 1,000,000 AI tokens a month. Here’s your checkout link:
chk_test_8F2kQ…Claude Code Adds the MCP server and five skills.
$
/plugin marketplace add kelviq/agent-toolkit$
/plugin install kelviq@kelviqMCP client Cursor, VS Code, Devin Desktop and more.
$
npx -y @kelviq/mcp-server@latestSkills The five Kelviq skills, for Cursor, Codex and 70+ other agents.
$
npx skills add kelviq/agent-toolkitCLI Pricing as code. In beta.
$
npm install -g @kelviq/cliSDKS
Check access and report usage from your stack
Check what a customer can use, and report what they used.
SDK referencenpm 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}`);
}
npm install -g @kelviq/cliNeeds Node.js 18 or newerkelviq loginPaste and store a Server API keykelviq pullWrite your remote catalog to kelviq.config.tskelviq push --dry-runPrint the diff and exit, never writeskelviq push --publishApply, then publish the plans it changedkelviq promoteMove 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 referenceSandbox
curl https://sandboxapi.kelviq.com/api/v1/catalog/products/ \
--header "Authorization: Bearer $KELVIQ_SANDBOX_SERVER_API_KEY" \
--header "Accept: application/json"- Checkout Open a hosted checkout for any plan.
- Customers Profiles, metadata and billing address.
- Subscriptions Create, read, change and cancel.
- Entitlements What each customer can use right now.
- Usage Report usage the moment it happens.
- Catalog Products, features and plans.
- Licenses Activate and validate license keys.
- Webhooks Signed deliveries for 22 events.
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.
software monetization.
Global tax, billing, metering, and entitlements. Ship your revenue stack in one deploy.