Rynko
Rynko
Sign InGet Started
MCP Integration

The Rynko MCP Server

Connect Claude Desktop, Cursor, Windsurf, VS Code, or Zed directly to Rynko via MCP. Design and validate document templates, generate PDFs and Excel files, and author and run database reports — all through natural conversation.

Get StartedGet Your Token
npx @rynko/mcp-server
RYNKO_USER_TOKEN=pat_...
npm|GitHub

How It Works

One local MCP server, launched with npx @rynko/mcp-server. Your AI tool talks to it over stdio; it talks to Rynko with your token.

Claude
Cursor
Windsurf
VS Code
Zed
MCP Protocol (stdio)
Rynko MCP Server
npx @rynko/mcp-server
templates · schema validation · reporting
Templates
PDF / Excel
Reports
Design → Validate → Generate

Templates and documents,
straight from chat.

Describe the document you need. Your AI assistant drafts a template, validates the schema, and generates a PDF or Excel file — all in one conversation, using your own Rynko environment.

  • create_draft_template → AI drafts a new template in draft mode
  • validate_schema → catches component and variable errors before publishing
  • get_schema_reference → the model always uses the correct schema
  • Draft-only by default → publishing stays a human decision
Claude Desktop — Rynko MCP

Auto-plays · click to replay

Structured schema errors

LLMs read our schema errors and fix themselves.

validate_schema returns precise, machine-readable errors — unknown component types, missing array item schemas, variables without defaults. The model reads them and corrects the template on its own.

No retry logic to write. No brittle prompt engineering.

type: "tabl""table"
items: array (no itemType)itemType: "object"
total: (no default)defaultValue: 0
Schema Self-Correction — LLM Agent

Auto-plays · click to replay

Try it yourself

Paste any of these prompts into Claude, Cursor, or any MCP-connected LLM. The agent discovers your templates, drafts the schema, hits validation errors, and self-corrects — no retry logic needed.

Invoice template from scratch

Create a draft invoice template with a header, a line-items table, tax, and a calculated total. Validate the schema and fix any errors until it passes.

Generate from an existing template

List my templates, find the sales quote template, and generate a PDF for Acme Corp — 10 hours of consulting at $150/hr plus 20% VAT.

Author a database report

List my reporting agents and datasources, inspect the orders table, then create and publish a monthly revenue report and run it as an Excel file.

Fix an invalid schema

Get the schema reference, then create a template that intentionally uses a wrong component type and an array variable with no itemType. Read the validation errors and correct every one.

Get Started

The Rynko MCP server runs locally over stdio via npx @rynko/mcp-server. Add the config below to your client and set RYNKO_USER_TOKEN to a personal access token.

Install command
npx @rynko/mcp-server
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "rynko": {
      "command": "npx",
      "args": ["-y", "@rynko/mcp-server"],
      "env": {
        "RYNKO_USER_TOKEN": "pat_xxxxxxxx"
      }
    }
  }
}

Runs @rynko/mcp-server locally via npx. Requires Node.js and a personal access token. Restart Claude Desktop after saving.

Start Building

Template & document prompts
  • "List my templates"
  • "Create an invoice template with line items and tax"
  • "Validate this template schema and fix the errors"
  • "Generate a sales quote PDF for Acme Corp, $12,000"
Reporting prompts
  • "List my reporting agents and datasources"
  • "Show me the columns in the orders table"
  • "Create a monthly revenue report and publish it"
  • "Run the sales report and give me the Excel file"

MCP Tool Reference

15 tools spanning environments, template authoring, and database reporting.

Environment

select_environment

Switch the active project / environment context

Templates

list_templates

List all templates in the current environment

get_template

Get full template details including its schema

create_draft_template

Create a new template in draft mode

update_draft_template

Update an existing draft template

validate_schema

Validate a template schema and return errors

get_schema_reference

Get the full template schema reference

Reporting

list_report_agents

List connected on-prem reporting agents

list_datasources

List the databases an agent can query

get_datasource_schema

Inspect tables and columns of a datasource

create_query_object

Create a reusable query object (draft)

publish_query_object

Publish a query object for use in reports

create_report

Create a report definition (draft)

publish_report

Publish a report so it can be run or scheduled

run_report

Run a report and render a PDF or Excel output

Use Cases

Real-world scenarios where AI + Rynko shines.

Design a Template by Describing It
You
Draft a packing-slip template with our logo, a shipment table, and a QR code for the tracking number.
AI

Creating a draft template and validating the schema...

✓ VALID · 0 errors

Draft created. Preview and publish it from your dashboard.

Invoice Generation from Conversation
You
Create an invoice for Acme Corp. 10 hours of consulting at $150/hr. Add 20% VAT.
AI

Generating a PDF from your "Professional Invoice" template.

  • Subtotal: $1,500.00 · VAT (20%): $300.00 · Total: $1,800.00

PDF generated. Download link valid for 24 hours.

Author and Run a Database Report
You
Build a monthly revenue report from our orders database and run it as an Excel file.
AI

Inspecting the orders datasource, creating a query object, and publishing the report...

✓ Report published · running now

Excel report rendered by your on-prem agent. Data never left your network.

Catch Schema Errors Before Publishing
You
Update the report template to add a summary chart and validate it.
AI

Updating the draft and running validate_schema...

✗ INVALID · 2 errors
• chart series references unknown variable "revenu"
• array variable "months" missing itemType

Fixing both and revalidating — no broken template ever reaches publish.

Security

Enterprise-grade security by default.

Draft-Only Mode

AI agents can only create draft templates and reports. Publishing requires human approval in the dashboard.

Revocable Tokens

The server authenticates with a personal access token you generate — and can revoke at any time — from your dashboard.

Full Audit Trail

Every AI action is logged with timestamp and user context. View it in your activity feed.

Ready to Build with AI?

Install the server with npx @rynko/mcp-server, add your token, and start generating documents from chat.

Get Started FreeFull Documentation