# @korala/mcp

Model Context Protocol server for Korala: lets AI assistants prepare, send and track signing requests

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the package rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 0.3.1
- **Author:** Unknown
- **License:** MIT
- **npm:** @korala/mcp
- **Endpoints:** streamable-http https://api.korala.ai/mcp
- **Source:** https://docs.korala.ai/ai-agents
- **Endpoint health:** reachable (last checked 2026-09-20T11:19:28.411Z, 1 sample) — uptime is not a security property and is not part of the trust score
- **Compatible clients:** claude-code, cursor, copilot, chatgpt, gemini (basis: transport)

## Trust

60/100 (B), scored on the package rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 0 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-21T10:39:23.213Z
- **Version scanned:** 0.3.1
- **CVEs:** none found by OSV at scan time

## Tools

25 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `upload_attached_pdf` — Turn a PDF the user attached to this chat into a Korala draft
- `list_documents` — List documents in the connected Korala organization, newest first.
- `get_document` — Get one document with its status, signers (and who has signed), and
- `get_audit_trail` — Get the full audit trail of a document: created, sent, viewed,
- `get_form_fields` — List the fillable form fields embedded in an uploaded PDF (tax forms
- `create_upload_url` — Step 1 of uploading an existing PDF: returns a documentId and a
- `confirm_upload` — Step 2 of uploading a PDF, after the bytes were PUT to the upload
- `request_pdf_upload` — When the user has a PDF to get signed and you hold neither the
- `add_signer` — Add a recipient to a draft document. Use the exact name and email
- `import_form_fields` — Place every field a fillable PDF declares (text boxes, checkboxes,
- `view_page` — For placing fields this is a fallback, not a first step: try
- `read_text` — ONLY when you cannot read the PDF yourself. If the file is
- `find_text` — Search an uploaded PDF for a phrase. You cannot see the PDF, so
- `add_field_at_text` — Place a signature, initials, date, text or checkbox field against
- `add_field` — Place a field at exact coordinates on a draft document for one
- `update_field` — Correct a field on a draft document: move it, resize it, relabel
- `remove_field` — Remove one field from a draft document: a duplicate, or one
- `send_document` — Send a draft document to its signers. This emails real people and
- `void_document` — Cancel a document so nobody can sign it. Irreversible, and signers
- `create_draft_link` — Turn a Markdown agreement into an "Open in Korala" link. Needs no
- `list_templates` — List reusable templates in the organization. Check here before
- `get_template` — Get a template with its signer roles, fields and (for Markdown
- `preview_markdown_template` — Render a Markdown agreement without saving anything. Returns page
- `create_markdown_template` — Save a Markdown agreement as a reusable template. Each
- `create_document_from_template` — Create a draft document from a template: assign a real person to

## Install

**Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for.
**Cautions** (coverage gaps and advisories — never blocking)
- No publisher has proved control of this listing; it is indexed, not vouched for.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@korala/mcp\"\n      ],\n      \"env\": {\n        \"KORALA_API_SECRET\": \"<YOUR_KORALA_API_SECRET>\"\n      }\n    }\n  }\n}"
```
**Credentials it will ask for** (names only — Forge never holds a value):
- `KORALA_API_SECRET` — Korala API Secret (optional)
Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each <YOUR_NAME> in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one.
- This entry needs 1 credential (0 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset.

## Blast radius

Extensive blast radius — deletes data; runs locally and hosted.
- Floor 59, ceiling 59 (tier: extensive)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/%40korala%2Fmcp
- Install plan: https://forgeregistry.com/api/v1/packages/%40korala%2Fmcp/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/%40korala%2Fmcp
- HTML page: https://forgeregistry.com/registry/%40korala%2Fmcp
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.