Skip to main content
Glama
softvoyagers

PismoSzyteNaMiare MCP Server

by softvoyagers

PismoSzyteNaMiare MCP Server

Website API Status npm

Integrate PismoSzyteNaMiare into Claude, Cursor, VS Code, and any MCP-compatible AI assistant.

Generate umowy kupna-sprzedaży, pełnomocnictwa, wypowiedzenia umów, umowy pożyczki, and protokoły zdawczo-odbiorcze 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:

{
  "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

Related MCP server: LegalForge MCP Server

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:

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. 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 free API portfolio.

Product

Domain

LinkMeta

linkmeta.dev

PageShot

pageshot.site

PDFSpark

pdfspark.dev

OGForge

ogforge.dev

LinkShrink

linkshrink.dev

Faktuj

faktuj.pl

QRMint

qrmint.dev

PageDrop

pagedrop.dev

Available Tools

2 tools
example_getC

Get example data from the PismoSzyteNaMiare API. Replace with your real tool.

ParametersJSON Schema
NameRequiredDescriptionDefault
queryNoOptional query parameter

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full behavioral burden, yet it discloses nothing about safety, permissions, return behavior, or side effects. Only the verb 'Get' weakly implies a read operation, which is minimal disclosure for a tool with zero annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The text is short and front-loaded with the purpose, which is good. But the second sentence ('Replace with your real tool') is authoring meta-instruction that provides no value to a calling agent, so not every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations, no output schema, and a placeholder resource name, the description does not compensate for the missing behavioral and return-value context. An agent cannot confidently determine what to expect from a call.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with a single optional 'query' parameter, so the schema already documents the parameter. The description adds no syntax, format, or meaning beyond what the schema provides, making the baseline 3 appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a verb (Get) and a resource (example data) plus the source API, so the basic purpose is parseable. However, 'example data' is a placeholder rather than a real resource, and the instruction to 'Replace with your real tool' signals this is a stub. It distinguishes from example_post only implicitly via the GET verb.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus the sibling example_post, nor any conditions, prerequisites, or exclusions. The agent is left to infer usage entirely from the name.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

example_postD

Post data to the PismoSzyteNaMiare API. Replace with your real tool.

ParametersJSON Schema
NameRequiredDescriptionDefault
inputYesInput data to process

TDQS

D1.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full behavioral burden, and it discloses nothing: no auth requirements, no side effects, no idempotency or failure behavior, no indication of what is created or returned. A mutation tool with zero behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Short, but the second sentence is boilerplate placeholder text that carries no operational meaning and signals an unfinished definition. Brevity here reflects under-specification rather than efficient editing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations, no output schema, and a placeholder description, nothing tells the agent how to call this safely or what to expect. The definition is not usable as written.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% for the single "input" parameter, so the schema already documents it. The description adds no format, encoding, or content guidance beyond that, which is the baseline expectation when the schema does the work.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Post data to the PismoSzyteNaMiare API" names a verb and a target, but the target is an unnamed template placeholder and "Replace with your real tool" explicitly admits the content is not real. An agent cannot determine what resource is being posted or how this differs from the sibling example_get.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No when-to-use guidance, no conditions, no exclusions, and no mention of the sibling example_get even though it is the obvious read counterpart to this write tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv1.0.0
    • First observedexample_get
    • First observedexample_post

TDQS

C2.2/5.0

Scored across 2 tools

Disambiguation3/5

The two tools are distinguishable by HTTP semantics (get vs. post), so there is no direct overlap. However, both descriptions are generic placeholders ('example data') and give no domain context, leaving real boundaries unclear.

Naming Consistency4/5

Both names follow the same predictable <noun>_<method> pattern (example_get, example_post), which is easy to parse. The 'example' placeholder noun is not a meaningful domain entity, but consistency itself is solid.

Tool Count3/5

With only two tools, the surface is thin for any real API server, and both are explicitly marked as placeholders. It is borderline rather than an extreme mismatch, since a minimal get/post pair can be a legitimate starting scope.

Completeness2/5

Only read and create-style operations exist; there is no update, delete, search, or domain-specific lifecycle coverage. As a template with no real surface, it cannot support meaningful agent workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Enables AI-powered legal research and analysis of Polish legal acts from the Sejm API. Provides comprehensive search, document retrieval, metadata analysis, and content access for legal documents from Dziennik Ustaw and Monitor Polski.
    13
    21
    MIT
  • F
    license
    B
    quality
    Not graded
    maintenance
    Enables the generation of professional, jurisdiction-specific legal documents like privacy policies, terms of service, and cookie policies. It allows users to produce structured HTML legal content by providing specific parties, terms, and service configurations to an AI-driven tool.
    1
    -
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to interact with the Polish National e-Invoice System (KSeF) for authentication, invoice creation, validation, and retrieval via 30 tools.
    32
    4
    MIT