Where do I find my Quaderno API Key and URL?

Log in to your Quaderno account. Your **API URL** is simply your domain up top in the browser bar (e.g., `https://mycompany.quadernoapp.com`). To get the **API Key**, navigate to **Settings** > **API Keys** (or Developers), and copy your private key. Do not share this key as it carries full access. Paste both credentials below.

Can it calculate exact taxes dynamically before a sale?

Yes! Use the `calculate_taxes` tool and just provide the AI with a country code, postal code, and base amount. Quaderno's world-class engine evaluates real-time location-based tax nuances (VAT, GST) and returns the exact fraction needed.

Can I draft custom test invoices natively in chat?

Absolutely. You can use `create_transaction`. Instruct your agent to format a JSON array with products and amounts, linking to a specific `contact_id`. The server submits this array to Quaderno and records the fully realized transaction safely.

Will deleting a contact via the AI remove them permanently?

Yes. The `delete_contact` operation relies heavily on standard destructive API instructions. Running this means the contact is gone entirely from the Quaderno dashboard. Always review deletion queries cautiously before approving execution.

Quaderno MCP Server for Vercel AI SDK 10 tools — connect in under 2 minutes

Name: Quaderno
Availability: InStock
Author: Vinkius

ai-sdk.dev/docs/ai-sdk-core/mcp

Built by Vinkius GDPR 10 Tools SDK

The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect Quaderno through Vinkius and every tool is available as a typed function. ready for React Server Components, API routes, or any Node.js backend.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

typescript

import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

async function main() {
  const mcpClient = await createMCPClient({
    transport: {
      type: "http",
      // Your Vinkius token. get it at cloud.vinkius.com
      url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    },
  });

  try {
    const tools = await mcpClient.tools();
    const { text } = await generateText({
      model: openai("gpt-4o"),
      tools,
      prompt: "Using Quaderno, list all available capabilities.",
    });
    console.log(text);
  } finally {
    await mcpClient.close();
  }
}

main();

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Quaderno MCP Server

Connect your Quaderno account to any AI agent and bring powerful tax compliance, invoicing, and customer management capabilities directly into your automated workflows.

The Vercel AI SDK gives every Quaderno tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 10 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.

What you can do

Tax Calculations on the Fly — Instantly determine the accurate sales tax, VAT, or GST based on the customer's region and amount before finalizing sales logic
Invoice Management — Search and retrieve generated invoices, audit billing records, and verify transactions perfectly formatted via intelligent prompts
Generate Transactions — Transact and issue invoices seamlessly by sending a simple JSON array of itemized products and line item prices
Full Contact CRM — Map your users fully by creating, modifying, retrieving, and safely deleting user contacts and billing profiles natively

The Quaderno MCP Server exposes 10 tools through the Vinkius. Connect it to Vercel AI SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Quaderno to Vercel AI SDK via MCP

Follow these steps to integrate the Quaderno MCP Server with Vercel AI SDK.

Install dependencies

Run npm install @ai-sdk/mcp ai @ai-sdk/openai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the script

Save to agent.ts and run with npx tsx agent.ts

Explore tools

The SDK discovers 10 tools from Quaderno and passes them to the LLM

Why Use Vercel AI SDK with the Quaderno MCP Server

Vercel AI SDK provides unique advantages when paired with Quaderno through the Model Context Protocol.

TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box

Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same Quaderno integration everywhere

Built-in streaming UI primitives let you display Quaderno tool results progressively in React, Svelte, or Vue components

Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency

Quaderno + Vercel AI SDK Use Cases

Practical scenarios where Vercel AI SDK combined with the Quaderno MCP Server delivers measurable value.

AI-powered web apps: build dashboards that query Quaderno in real-time and stream results to the UI with zero loading states

API backends: create serverless endpoints that orchestrate Quaderno tools and return structured JSON responses to any frontend

Chatbots with tool use: embed Quaderno capabilities into conversational interfaces with streaming responses and tool call visibility

Internal tools: build admin panels where team members interact with Quaderno through natural language queries

Quaderno MCP Tools for Vercel AI SDK (10)

These 10 tools become available when you connect Quaderno to Vercel AI SDK via MCP:

calculate_taxes

Calculates applicable taxes for a potential sale

create_contact

Specify email, first name, and last name. Creates a new contact in Quaderno

create_transaction

Provide the contact ID and a JSON array of items. Records a new transaction and issues an invoice

delete_contact

This action is irreversible. Deletes a contact from Quaderno

get_contact

Retrieves details for a specific contact

get_invoice

Retrieves details for a specific invoice

list_contacts

Lists all contacts (customers) in the Quaderno account

list_invoices

Lists all issued invoices

list_transactions

Lists all recorded transactions

update_contact

Provide a JSON payload with the changes. Updates an existing contact

Example Prompts for Quaderno in Vercel AI SDK

Ready-to-use prompts you can give your Vercel AI SDK agent to start working with Quaderno immediately.

"Calculate the taxes for a $150 plan sold to a user in Berlin, Germany (Postal Code 10115)."

"Fetch the billing details and history for contact ID #9822."

"Update contact #9822 to change its first name to 'Acorn Group Inc'."

Troubleshooting Quaderno MCP Server with Vercel AI SDK

Common issues when connecting Quaderno to Vercel AI SDK through the Vinkius, and how to resolve them.

createMCPClient is not a function

Install: npm install @ai-sdk/mcp

Quaderno + Vercel AI SDK FAQ

Common questions about integrating Quaderno MCP Server with Vercel AI SDK.

How does the Vercel AI SDK connect to MCP servers?

Import createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.