# PismoSzyteNaMiare MCP Server

[![Website](https://img.shields.io/badge/Website-pismoszytenamiare.pl-00f0ff?style=flat-square)](https://pismoszytenamiare.pl)
[![API Status](https://img.shields.io/badge/API-Free%20Forever-39ff14?style=flat-square)](https://pismoszytenamiare.pl/docs)
[![npm](https://img.shields.io/npm/v/pismoszytenamiare-mcp?style=flat-square&color=ff00aa)](https://www.npmjs.com/package/pismoszytenamiare-mcp)

> Integrate [PismoSzyteNaMiare](https://pismoszytenamiare.pl) into Claude, Cursor, VS Code, and any MCP-compatible AI assistant.

Generate [umowy kupna-sprzedaży](https://pismoszytenamiare.pl/umowa-kupna-sprzedazy), [pełnomocnictwa](https://pismoszytenamiare.pl/pelnomocnictwo), [wypowiedzenia umów](https://pismoszytenamiare.pl/wypowiedzenie-umowy), [umowy pożyczki](https://pismoszytenamiare.pl/umowa-pozyczki), and [protokoły zdawczo-odbiorcze](https://pismoszytenamiare.pl/protokol-zdawczo-odbiorczy) directly from your AI assistant.

**No API key required. Free forever.**

## Quick Start

### Claude Desktop (stdio)

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "pismoszytenamiare": {
      "command": "npx",
      "args": ["pismoszytenamiare-mcp"]
    }
  }
}
```

### Claude.ai / Remote MCP (HTTP)

Connect via the Glama connector or directly:

```
https://softvoyagers-pismoszytenamiare-mcp.azurewebsites.net/mcp
```

## Available Tools

| Tool | Description |
|------|-------------|
| `generate_document` | Generate a legal document PDF from structured input data |
| `list_document_types` | List all supported document types and their required fields |
| `get_document_preview` | Preview a document before generating the final PDF |

## Supported Documents

PismoSzyteNaMiare generates professionally formatted Polish legal documents, including:

- [Umowa kupna-sprzedaży](https://pismoszytenamiare.pl/umowa-kupna-sprzedazy) — sales contract generator for vehicles, real estate, and other assets
- [Pełnomocnictwo](https://pismoszytenamiare.pl/pelnomocnictwo) — power of attorney generator with customizable scope and duration
- [Wypowiedzenie umowy](https://pismoszytenamiare.pl/wypowiedzenie-umowy) — contract termination letter generator for leases, subscriptions, and services
- [Umowa pożyczki](https://pismoszytenamiare.pl/umowa-pozyczki) — loan agreement generator with interest rates and repayment schedules
- [Protokół zdawczo-odbiorczy](https://pismoszytenamiare.pl/protokol-zdawczo-odbiorczy) — handover protocol generator for apartments, offices, and equipment

Each document type supports full customization of parties, terms, and clauses. All generated documents are valid under Polish law.

## Architecture

This MCP server is a thin client over the [PismoSzyteNaMiare REST API](https://pismoszytenamiare.pl/docs).
All requests are forwarded to `https://pismoszytenamiare.pl` — no data is processed or stored here.

| Transport | Usage |
|-----------|-------|
| **stdio** | `npx pismoszytenamiare-mcp` — for local Claude Desktop |
| **HTTP** | `https://softvoyagers-pismoszytenamiare-mcp.azurewebsites.net/mcp` — for Glama & remote |

## Part of SoftVoyagers

Part of the [SoftVoyagers](https://github.com/softvoyagers) free API portfolio.

| Product | Domain |
|---------|--------|
| LinkMeta | [linkmeta.dev](https://linkmeta.dev) |
| PageShot | [pageshot.site](https://pageshot.site) |
| PDFSpark | [pdfspark.dev](https://pdfspark.dev) |
| OGForge | [ogforge.dev](https://ogforge.dev) |
| LinkShrink | [linkshrink.dev](https://linkshrink.dev) |
| Faktuj | [faktuj.pl](https://faktuj.pl) |
| QRMint | [qrmint.dev](https://qrmint.dev) |
| PageDrop | [pagedrop.dev](https://pagedrop.dev) |