Kamy

Official12 toolsLive

by Kamy-Development

Document API for AI-native software: render PDFs, e-sign, PAdES-seal, and verify.

Model Context Protocol (MCP) Server: dev.kamy/kamy

The dev.kamy/kamy MCP server provides a document API for AI-native software. It supports rendering PDFs, e-signing, applying PAdES-seals, and verifying documents. The server is identified as “dev.kamy/kamy” and exposes 12 tools, with topics spanning model-context-protocol and related tooling.

🛠️ Key Features

PDF rendering
E-signatures
PAdES-seal functionality
Document verification
12 available tools

🚀 Use Cases

Generate rendered PDF outputs for downstream AI workflows
Perform electronic signing with PAdES sealing
Verify documents as part of document processing pipelines

⚡ Developer Benefits

API access tailored to AI-native software
Integration surface aligned with model-context-protocol
Context for development using topics such as claude-code, cursor, and open-plugins

Topics

claude-codecursorkamymcp-servermodel-context-protocolopen-pluginspdf

Captured live from the server via tools/list.

list_templates

List Kamy's public system PDF templates. No authentication required.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

render_pdf

Render a PDF from a Kamy template and data when a Kamy API key is configured. Without a key, returns dashboard setup instructions.

Parameters3

template	string	required	Template slug (e.g., 'invoice') or template UUID
data	object	required	Data to populate the template
format	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "template": {
      "type": "string",
      "description": "Template slug (e.g., 'invoice') or template UUID"
    },
    "data": {
      "type": "object",
      "additionalProperties": {},
      "description": "Data to populate the template"
    },
    "format": {
      "type": "string",
      "enum": [
        "a4",
        "letter"
      ],
      "default": "a4"
    }
  },
  "required": [
    "template",
    "data"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

extract_document

Extract structured data from a PDF (invoice, receipt, contract, ID document, or any form). Returns the parsed JSON plus a public verify URL that proves the extraction matches the source. Use this when an agent needs to read an inbound document and act on it.

Parameters3

template	string	required	Predefined template id. invoice/receipt for AP and POS docs, contract for legal agreements, id_document for passports/IDs, generic_form for anything else.
source_url	string	optional	Public URL to a PDF (preferred). One of source_url or source_base64 is required.
source_base64	string	optional	Base64-encoded PDF bytes. Use when the source isn't publicly fetchable.

Raw schema

{
  "type": "object",
  "properties": {
    "template": {
      "type": "string",
      "enum": [
        "invoice",
        "receipt",
        "contract",
        "id_document",
        "generic_form"
      ],
      "description": "Predefined template id. invoice/receipt for AP and POS docs, contract for legal agreements, id_document for passports/IDs, generic_form for anything else."
    },
    "source_url": {
      "type": "string",
      "format": "uri",
      "description": "Public URL to a PDF (preferred). One of source_url or source_base64 is required."
    },
    "source_base64": {
      "type": "string",
      "description": "Base64-encoded PDF bytes. Use when the source isn't publicly fetchable."
    }
  },
  "required": [
    "template"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ask_kamy

Ask Kamy Brain a question about Kamy usage, templates, plans, or errors. Sends the question to Kamy's public assistant endpoint and returns a paragraph answer.

Parameters1

question

string

required

The question to ask Kamy about — how to render a template, why a render failed, what plan to pick, etc.

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The question to ask Kamy about — how to render a template, why a render failed, what plan to pick, etc."
    }
  },
  "required": [
    "question"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

install_sdk

Get install commands and setup code for @kamydev/sdk in your framework.

Parameters2

framework	string	required	The framework the user is working with
packageManager	string	optional	Package manager to use

Raw schema

{
  "type": "object",
  "properties": {
    "framework": {
      "type": "string",
      "enum": [
        "nextjs",
        "remix",
        "sveltekit",
        "astro",
        "express",
        "fastify",
        "hono",
        "fastapi",
        "flask"
      ],
      "description": "The framework the user is working with"
    },
    "packageManager": {
      "type": "string",
      "enum": [
        "npm",
        "pnpm",
        "yarn",
        "bun"
      ],
      "default": "npm",
      "description": "Package manager to use"
    }
  },
  "required": [
    "framework"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

generate_integration_code

Generate copy-paste integration code for a specific Kamy template and framework.

Parameters2

template	string	required	Template slug (e.g., 'invoice')
framework	string	required	Target framework

Raw schema

{
  "type": "object",
  "properties": {
    "template": {
      "type": "string",
      "description": "Template slug (e.g., 'invoice')"
    },
    "framework": {
      "type": "string",
      "enum": [
        "nextjs",
        "remix",
        "express",
        "fastify",
        "hono",
        "fastapi",
        "flask"
      ],
      "description": "Target framework"
    }
  },
  "required": [
    "template",
    "framework"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_signature_request

Send a previously rendered PDF to a signer for e-signature when a Kamy API key is configured. Without a key, returns dashboard setup instructions.

Parameters14

renderId	string	required	Render UUID returned by render_pdf or any /v1/render call. The render's PDF is the document the signer will receive.
signerEmail	string	required	Recipient email address.
signerName	string	required	Recipient full name. Must be typed verbatim by the signer to confirm intent.
position	object	optional	Optional sender-chosen signature placement in PDF points (72 dpi, origin bottom-left). Defaults to bottom-right of the last page sized 220×64 pt; when omitted, the signer can drag the placeholder on the sign page.
message	string	optional	Optional message rendered in the email invitation body.
authMethod	string	optional	Identity-verification mode. `link` (default) — possession of the secret URL is the only check. `email_otp` — sign page renders a 6-digit OTP gate; code emailed to `signerEmail`. `sms_otp` — same gate, code texted to `signerPhone` (which must then be supplied). Recommend `email_otp` for higher-value transactions.
signerPhone	string	optional	E.164 phone number. Required when `authMethod` is `sms_otp`; ignored otherwise. Example: `+14155551234`.
ccEmails	array	optional	Up to 10 observer addresses CC'd on the invite and the completion notice. Not signers themselves.
expiresIn	integer	optional	How long (seconds) the sign link stays valid. Defaults to 30 days. Min 1 hour, max 30 days.
reminderCadenceHours	integer	optional	When set (24–168), the auto-reminder cron resends the invite every N hours while the request stays pending, up to 3 reminders. Omit for no auto-reminders.
signOnEveryPage	boolean	optional	When true, the server stamps the signer's signature on every page of the source PDF instead of only the configured position. Common B2B contract pattern.
requireStamp	boolean	optional	Require the signer to upload a company stamp / seal alongside their personal signature (UAE, KSA, JP, KR, IN, CN B2B workflows). Server refuses to seal without one.
signatureTemplateId	string	optional	Apply a signature template's defaults (placedFields, position, message, expiresIn, ccEmails). Request-level fields override the template.
placedFields	array	optional	Up to 100 sender-defined fillable fields stamped onto the PDF at sign time. Use for flat PDFs that don't ship AcroForm widgets. Names must be unique.

Raw schema

{
  "type": "object",
  "properties": {
    "renderId": {
      "type": "string",
      "format": "uuid",
      "description": "Render UUID returned by render_pdf or any /v1/render call. The render's PDF is the document the signer will receive."
    },
    "signerEmail": {
      "type": "string",
      "format": "email",
      "description": "Recipient email address."
    },
    "signerName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Recipient full name. Must be typed verbatim by the signer to confirm intent."
    },
    "position": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "minimum": 1,
          "maximum": 500
        },
        "x": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000
        },
        "y": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000
        },
        "w": {
          "type": "number",
          "minimum": 40,
          "maximum": 800
        },
        "h": {
          "type": "number",
          "minimum": 20,
          "maximum": 400
        }
      },
      "additionalProperties": false,
      "description": "Optional sender-chosen signature placement in PDF points (72 dpi, origin bottom-left). Defaults to bottom-right of the last page sized 220×64 pt; when omitted, the signer can drag the placeholder on the sign page."
    },
    "message": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional message rendered in the email invitation body."
    },
    "authMethod": {
      "type": "string",
      "enum": [
        "link",
        "sms_otp",
        "email_otp"
      ],
      "description": "Identity-verification mode. `link` (default) — possession of the secret URL is the only check. `email_otp` — sign page renders a 6-digit OTP gate; code emailed to `signerEmail`. `sms_otp` — same gate, code texted to `signerPhone` (which must then be supplied). Recommend `email_otp` for higher-value transactions."
    },
    "signerPhone": {
      "type": "string",
      "pattern": "^\\+[1-9]\\d{6,14}$",
      "description": "E.164 phone number. Required when `authMethod` is `sms_otp`; ignored otherwise. Example: `+14155551234`."
    },
    "ccEmails": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "email"
      },
      "maxItems": 10,
      "description": "Up to 10 observer addresses CC'd on the invite and the completion notice. Not signers themselves."
    },
    "expiresIn": {
      "type": "integer",
      "minimum": 3600,
      "maximum": 2592000,
      "description": "How long (seconds) the sign link stays valid. Defaults to 30 days. Min 1 hour, max 30 days."
    },
    "reminderCadenceHours": {
      "type": "integer",
      "minimum": 24,
      "maximum": 168,
      "description": "When set (24–168), the auto-reminder cron resends the invite every N hours while the request stays pending, up to 3 reminders. Omit for no auto-reminders."
    },
    "signOnEveryPage": {
      "type": "boolean",
      "description": "When true, the server stamps the signer's signature on every page of the source PDF instead of only the configured position. Common B2B contract pattern."
    },
    "requireStamp": {
      "type": "boolean",
      "description": "Require the signer to upload a company stamp / seal alongside their personal signature (UAE, KSA, JP, KR, IN, CN B2B workflows). Server refuses to seal without one."
    },
    "signatureTemplateId": {
      "type": "string",
      "format": "uuid",
      "description": "Apply a signature template's defaults (placedFields, position, message, expiresIn, ccEmails). Request-level fields override the template."
    },
    "placedFields": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Unique field name within the request."
          },
          "type": {
            "type": "string",
            "enum": [
              "text",
              "textarea",
              "checkbox",
              "date",
              "initials",
              "radio",
              "dropdown"
            ]
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "description": "1-indexed page number."
          },
          "x": {
            "type": "number",
            "minimum": 0,
            "maximum": 2000,
            "description": "Bottom-left x in PDF points."
          },
          "y": {
            "type": "number",
            "minimum": 0,
            "maximum": 2000,
            "description": "Bottom-left y in PDF points."
          },
          "w": {
            "type": "number",
            "minimum": 8,
            "maximum": 800,
            "description": "Width in PDF points."
          },
          "h": {
            "type": "number",
            "minimum": 8,
            "maximum": 800,
            "description": "Height in PDF points."
          },
          "required": {
            "type": "boolean"
          },
          "defaultValue": {
            "type": "string",
            "maxLength": 2000
          },
          "signerLabel": {
            "type": "string",
            "maxLength": 200
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "minItems": 1,
            "maxItems": 50,
            "description": "Valid choices for radio / dropdown."
          },
          "anchor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Text anchor — server locates this string in the PDF and uses its position."
          }
        },
        "required": [
          "name",
          "type",
          "page",
          "x",
          "y",
          "w",
          "h"
        ],
        "additionalProperties": false
      },
      "maxItems": 100,
      "description": "Up to 100 sender-defined fillable fields stamped onto the PDF at sign time. Use for flat PDFs that don't ship AcroForm widgets. Names must be unique."
    }
  },
  "required": [
    "renderId",
    "signerEmail",
    "signerName"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_signature_requests

List signature requests created by the configured Kamy account, newest first. Without a key, returns dashboard setup instructions.

Parameters2

limit	integer	optional	Default 50.
offset	integer	optional	Default 0.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Default 50."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Default 0."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_signature_certificate

Returns the authenticated download URL for a signature request's Certificate of Completion PDF — the process audit trail (invite → opened → consent → signed, with IP / user-agent) that legal teams expect. Only available after the request reaches a terminal state. Without a key, returns dashboard setup instructions.

Parameters1

signatureRequestId

string

required

ID of the signature_request to fetch the Certificate of Completion for. Must be in a terminal state (signed / declined / delegated / voided / expired); pending requests return 409.

Raw schema

{
  "type": "object",
  "properties": {
    "signatureRequestId": {
      "type": "string",
      "format": "uuid",
      "description": "ID of the signature_request to fetch the Certificate of Completion for. Must be in a terminal state (signed / declined / delegated / voided / expired); pending requests return 409."
    }
  },
  "required": [
    "signatureRequestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

pki_sign_pdf

Cryptographically sign an existing render with PAdES when a Kamy API key is configured. Without a key, returns dashboard setup instructions.

Parameters7

renderId	string	required	Render UUID returned by render_pdf or any /v1/render call. The PDF will be sealed with a Kamy-issued X.509 leaf certificate.
reason	string	optional	Optional /Sig dictionary Reason — surfaced in Acrobat's signature panel. ASCII-coerced server-side.
location	string	optional	Optional /Sig dictionary Location.
signerName	string	optional	Override the signer display name. Defaults to the account's full_name.
signerEmail	string	optional	Override the signer email. Defaults to the account's email.
withTimestamp	boolean	optional	When false, skip the RFC 3161 timestamp call (PAdES-B-B instead of B-T). Default: true.
withRevocationInfo	boolean	optional	When false, skip embedding the Kamy CA CRL into the PKCS#7 SignedData (PAdES-B-T instead of B-LT). Online verifiers can still fetch the CRL via the Distribution Point on the leaf cert. Default: true.

Raw schema

{
  "type": "object",
  "properties": {
    "renderId": {
      "type": "string",
      "format": "uuid",
      "description": "Render UUID returned by render_pdf or any /v1/render call. The PDF will be sealed with a Kamy-issued X.509 leaf certificate."
    },
    "reason": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional /Sig dictionary Reason — surfaced in Acrobat's signature panel. ASCII-coerced server-side."
    },
    "location": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional /Sig dictionary Location."
    },
    "signerName": {
      "type": "string",
      "maxLength": 120,
      "description": "Override the signer display name. Defaults to the account's full_name."
    },
    "signerEmail": {
      "type": "string",
      "format": "email",
      "description": "Override the signer email. Defaults to the account's email."
    },
    "withTimestamp": {
      "type": "boolean",
      "description": "When false, skip the RFC 3161 timestamp call (PAdES-B-B instead of B-T). Default: true."
    },
    "withRevocationInfo": {
      "type": "boolean",
      "description": "When false, skip embedding the Kamy CA CRL into the PKCS#7 SignedData (PAdES-B-T instead of B-LT). Online verifiers can still fetch the CRL via the Distribution Point on the leaf cert. Default: true."
    }
  },
  "required": [
    "renderId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_pdf_signature

Compute the kamy.dev/verify URL for a PDF without making a Kamy API call. Pass the PDF as base64; the MCP Worker hashes it in-memory and does not store or forward it.

Parameters1

pdfBase64

string

required

Base64-encoded PDF bytes. The MCP Worker hashes the file in-memory and does not store or forward it.

Raw schema

{
  "type": "object",
  "properties": {
    "pdfBase64": {
      "type": "string",
      "minLength": 1,
      "description": "Base64-encoded PDF bytes. The MCP Worker hashes the file in-memory and does not store or forward it."
    }
  },
  "required": [
    "pdfBase64"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_api_key_instructions

Return step-by-step instructions for creating a Kamy API key in the dashboard. Does not open the browser.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md3 KBView on GitHub

Kamy Plugin

MIT License

Open Plugins distribution for Kamy — install Kamy PDF generation in Cursor, Claude Code, and any other Open-Plugins-compatible AI coding agent.

This repository ships only the plugin manifest and the agent-facing assets (skill, rules, sub-agent, MCP config). The Kamy API, dashboard, SDK source, and template engine live in private infrastructure; this repo is the install surface for AI agents.

What's in this plugin

Path	Component	Purpose
`.plugin/plugin.json`	Manifest	Name, version, metadata, declared components
`skills/kamy/SKILL.md`	Skill	Teaches the agent when and how to render PDFs
`rules/kamy-sdk.mdc`	Rule	Coding conventions for `@kamydev/sdk` and the REST API
`agents/pdf-template-author.md`	Sub-agent	Specialised template-design agent (Handlebars + print CSS)
`.mcp.json`	MCP server	Hosted MCP at `mcp.kamy.dev` exposing render tools

Install

Point your Open-Plugins-compatible agent at this repository and follow the host's plugin-install flow:

code

https://github.com/Kamy-Development/kamy-plugin

The agent reads .plugin/plugin.json and loads the components automatically.

You will also need a Kamy API key. Grab one from kamy.dev/dashboard/keys and expose it as KAMY_API_KEY in your environment so the MCP server picks it up.

Use Kamy without the plugin

If you don't use an Open-Plugins-compatible agent, install the SDK or CLI directly:

bash

# SDK (Node, Bun, Deno, Workers, Edge, browser)
npm i @kamydev/sdk

# CLI (scripts, CI, previews)
npm i -g @kamydev/cli

Full docs at kamy.dev/docs.

Support

Docs — kamy.dev/docs
Status — kamy.dev/status
Changelog — kamy.dev/changelog
Email — support@kamy.dev
Security — security@kamy.dev

License

MIT — see LICENSE.

Install

Tools (12)

list_templatesrender_pdfextract_documentask_kamyinstall_sdkgenerate_integration_codecreate_signature_requestlist_signature_requests

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.kamy.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "kamy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.kamy.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Model Context Protocol (MCP) Server: dev.kamy/kamy

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

Topics

list_templates

render_pdf

extract_document

ask_kamy

install_sdk

generate_integration_code

create_signature_request

list_signature_requests

get_signature_certificate

pki_sign_pdf

verify_pdf_signature

get_api_key_instructions

Kamy Plugin

What's in this plugin

Install

Use Kamy without the plugin

Support

License

Install

Remote endpoint

Related servers