Server definition
- Hash
- sha256:8f98cf252b58472db6b4c13e8f05dcabcb1bb55f553efbbbab478a3d779c3fcd
- What it is
- What a remote MCP server returned when asked what it offers: 14 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Store the sender details printed on every proposal, contract and letter, plus the currency, VAT, terms and prefix defaults. It writes the SAME shared profile as the invoice server's business_set.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"address": {
"description": "Postal address, newlines allowed",
"type": "string"
},
"bank": {
"description": "Bank name / BIC",
"type": "string"
},
"brand_color": {
"description": "Letterhead colour as a hex code, e.g. 1F3864 (Pro)",
"type": "string"
},
"default_currency": {
"description": "ISO code, e.g. EUR, USD. Default EUR",
"pattern": "^[A-Za-z]{3}$",
"type": "string"
},
"default_tax_rate": {
"description": "Default VAT percent, quoted on proposals",
"type": "number"
},
"email": {
"description": "Your own email address, printed on every letterhead. Leave it out unless the user gave it: a document that shows an address nobody supplied is worse than one that shows [add: email]",
"type": "string"
},
"iban": {
"description": "IBAN or account number for payment",
"type": "string"
},
"invoice_prefix": {
"description": "Reference prefix used by mcp-invoice; this profile has the same field shape as mcp-invoice, so one profile serves both",
"type": "string"
},
"logo_path": {
"description": "Path to a PNG or JPG logo for the letterhead (Pro)",
"type": "string"
},
"name": {
"description": "Your business or freelancer name, printed on the letterhead of every proposal, contract and letter",
"type": "string"
},
"payment_terms_days": {
"description": "Default days until payment is due. Default 14",
"type": "number"
},
"phone": {
"description": "Your own phone number. Same rule as email: only if the user gave it",
"type": "string"
},
"tax_rate": {
"description": "Alias for default_tax_rate",
"type": "number"
},
"timezone": {
"description": "IANA zone you work in, e.g. Europe/Warsaw. Shared with time-tracker and timezone as your home zone",
"type": "string"
},
"vat": {
"description": "Alias for default_tax_rate",
"type": "number"
},
"vat_id": {
"description": "VAT / tax registration id",
"type": "string"
},
"vat_rate": {
"description": "Alias for default_tax_rate",
"type": "number"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "business_set",
"outputSchema": null
},
{
"description": "Call this tool to produce a freelance service agreement .docx. Returns the reference, the fee and the file path. It is a template skeleton for a lawyer to review, not legal advice. Free tier: 3 agreements per month.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"clauses": {
"description": "Extra clauses to append, one paragraph each",
"items": {
"type": "string"
},
"type": "array"
},
"client": {
"description": "The client's legal name",
"type": "string"
},
"end_date": {
"description": "YYYY-MM-DD, omit for an open-ended engagement",
"type": "string"
},
"fee": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "number"
},
"currency": {
"pattern": "^[A-Za-z]{3}$",
"type": "string"
},
"schedule": {
"description": "e.g. 'monthly in arrears' or '50% up front'",
"type": "string"
}
},
"required": [
"amount",
"schedule"
],
"type": "object"
},
"governing_law": {
"description": "e.g. 'the laws of Poland'",
"type": "string"
},
"out_path": {
"description": "Where to write the .docx. Defaults to the data directory",
"type": "string"
},
"overwrite": {
"description": "Replace out_path if a file is already there. Default false: an existing file is never overwritten",
"type": "boolean"
},
"services": {
"description": "What you will do, one or two sentences. The document adds parties, term, fee and schedule, plus standard clauses on intellectual property, confidentiality, independent contractor status, liability, termination and governing law",
"type": "string"
},
"start_date": {
"description": "YYYY-MM-DD",
"type": "string"
}
},
"required": [
"client",
"services",
"start_date",
"fee"
],
"type": "object"
},
"name": "contract_create",
"outputSchema": null
},
{
"description": "Call this tool to write a real .docx file from structured sections. Returns the file path, the number of blocks written and the layout used. Free and unlimited.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"date": {
"description": "Date line for the letter layout, default today",
"type": "string"
},
"out_path": {
"description": "Where to write the .docx. Defaults to the data directory",
"type": "string"
},
"overwrite": {
"description": "Replace out_path if a file is already there. Default false: an existing file is never overwritten",
"type": "boolean"
},
"recipient": {
"description": "Addressee block for the letter layout",
"type": "string"
},
"sections": {
"description": "Sections in order. Each one may carry a heading, paragraphs, a bullet or numbered list and a table",
"items": {
"additionalProperties": false,
"properties": {
"bullets": {
"description": "Bullet list items",
"items": {
"type": "string"
},
"type": "array"
},
"heading": {
"description": "Section heading",
"type": "string"
},
"level": {
"description": "Heading level, default 2",
"maximum": 6,
"minimum": 1,
"type": "integer"
},
"numbered": {
"description": "Numbered list items",
"items": {
"type": "string"
},
"type": "array"
},
"paragraphs": {
"description": "Body paragraphs. **bold**, *italic* and `code` are honoured",
"items": {
"type": "string"
},
"type": "array"
},
"table": {
"additionalProperties": false,
"description": "A table: one header row plus rows of cells",
"properties": {
"headers": {
"items": {
"type": "string"
},
"type": "array"
},
"rows": {
"items": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "array"
}
},
"required": [
"headers",
"rows"
],
"type": "object"
}
},
"type": "object"
},
"type": "array"
},
"style": {
"description": "Layout, default plain. plain is the title and the body; letter adds a sender block top right, a date and the addressee; proposal adds a letterhead band and a cover title",
"enum": [
"plain",
"letter",
"proposal"
],
"type": "string"
},
"title": {
"description": "Document title, used as the top heading and the file name",
"type": "string"
}
},
"required": [
"title",
"sections"
],
"type": "object"
},
"name": "doc_create",
"outputSchema": null
},
{
"description": "Delete one document uploaded for your token: name is the name it was uploaded under, without .docx. doc_files lists them. A name nothing is stored under is refused and nothing is deleted.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"name": {
"maxLength": 70,
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "doc_delete_upload",
"outputSchema": null
},
{
"description": "List the documents uploaded for your token, with their sizes.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "doc_files",
"outputSchema": null
},
{
"description": "Call this tool to replace {{placeholders}} in a .docx and write a new file, reporting what was filled, unfilled or ignored. Call it with no values to list them. Free: templates up to 10 placeholders.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"docx_base64": {
"description": "The .docx template itself, base64-encoded, instead of uploading it first",
"type": "string"
},
"out_path": {
"description": "Where to write the filled .docx. Defaults to <template>-filled.docx",
"type": "string"
},
"overwrite": {
"description": "Replace out_path if a file is already there. Default false: an existing file is never overwritten",
"type": "boolean"
},
"template_path": {
"description": "Name of a template uploaded with doc_upload",
"type": "string"
},
"values": {
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
},
"description": "Placeholder name to value, e.g. {client: \"Acme\", fee: \"EUR 4,500.00\"}",
"type": "object"
}
},
"type": "object"
},
"name": "doc_fill_template",
"outputSchema": null
},
{
"description": "Call this tool to turn markdown into a .docx, returning the file and a count of blocks by type. Headings, lists, GFM tables and code fences are honoured. Empty markdown is refused, and so is overwriting without the flag.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"markdown": {
"description": "The markdown source. ATX headings, paragraphs, bullet and numbered lists, GFM pipe tables and fenced code blocks as monospace are honoured, as are **bold**, *italic* and `code` inline",
"type": "string"
},
"out_path": {
"description": "Where to write the .docx. Defaults to the data directory",
"type": "string"
},
"overwrite": {
"description": "Replace out_path if a file is already there. Default false: an existing file is never overwritten",
"type": "boolean"
},
"style": {
"enum": [
"plain",
"letter",
"proposal"
],
"type": "string"
},
"title": {
"description": "Document title; defaults to the first heading in the markdown",
"type": "string"
}
},
"required": [
"markdown"
],
"type": "object"
},
"name": "doc_from_markdown",
"outputSchema": null
},
{
"description": "Call this tool to extract the text of an existing .docx. Returns an outline of the headings and the full text in document order, or the block structure. Free and unlimited.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"docx_base64": {
"description": "The .docx itself, base64-encoded, instead of uploading it first",
"type": "string"
},
"format": {
"description": "text (default) returns the readable text, json returns the block structure in document order",
"enum": [
"text",
"json"
],
"type": "string"
},
"path": {
"description": "Name of a document uploaded with doc_upload",
"type": "string"
}
},
"type": "object"
},
"name": "doc_read",
"outputSchema": null
},
{
"description": "Call this tool to convert a .docx to semantic HTML you can open in a browser and print to PDF. Returns the path of the .html file. This is the supported PDF route; no PDF is rendered here. Free and unlimited.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"out_path": {
"description": "Name for the downloaded .html file",
"type": "string"
},
"overwrite": {
"description": "Replace out_path if a file is already there. Default false: an existing file is never overwritten",
"type": "boolean"
},
"path": {
"description": "Name of a document uploaded with doc_upload, or a document this server just wrote",
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
},
"name": "doc_to_html",
"outputSchema": null
},
{
"description": "Send an existing Word document to this hosted endpoint. There is no filesystem here, so instead of a path you upload the file once with doc_upload and then pass its name as `path` to doc_read, doc_to_html and doc_fill_template. Give exactly one of docx_base64 or url. url: fetch a public file instead of pasting base64 (recommended above about 10 KB): a 13 KB base64 paste can take minutes to write out, while a url costs one line and the fetch happens here (10 second timeout, at most 3 redirects, public http(s) hosts only, 2 MB cap). Uploads are kept for your token between calls; doc_read and doc_fill_template also take docx_base64 directly; that file is stored under the name you give (default 'inline' / 'template') and can be removed with doc_delete_upload. Documents this server writes come back as a download link valid for one hour.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"docx_base64": {
"description": "The .docx file, base64-encoded",
"type": "string"
},
"name": {
"description": "Name to refer to this document by: 1-64 characters of letters, digits, underscore or dash, e.g. \"contract\"",
"maxLength": 70,
"minLength": 1,
"type": "string"
},
"url": {
"description": "url: fetch a public file instead of pasting base64 (recommended above about 10 KB). Public http(s) only; private, link-local and this endpoint's own zone are refused",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "doc_upload",
"outputSchema": null
},
{
"description": "Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"key": {
"description": "License key from checkout, MCPL1.<payload>.<signature>",
"type": "string"
}
},
"required": [
"key"
],
"type": "object"
},
"name": "license_activate",
"outputSchema": null
},
{
"description": "Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "license_status",
"outputSchema": null
},
{
"description": "Call this tool to produce a client-ready .docx proposal from summary, scope, deliverables, timeline, price and terms. Returns the reference, the total and the file path. Free tier: 3 proposals or contracts per month.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"client": {
"description": "Client name, printed as 'Prepared for'. The letterhead comes from your business_set profile",
"type": "string"
},
"deliverables": {
"description": "What the client receives, one bullet each. Omitted from the document if not given or empty",
"items": {
"type": "string"
},
"type": "array"
},
"out_path": {
"description": "Where to write the .docx. Defaults to the data directory",
"type": "string"
},
"overwrite": {
"description": "Replace out_path if a file is already there. Default false: an existing file is never overwritten",
"type": "boolean"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "Total price in major units, e.g. 4500",
"type": "number"
},
"currency": {
"pattern": "^[A-Za-z]{3}$",
"type": "string"
},
"terms": {
"description": "e.g. '50% on signature, 50% on delivery'",
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
},
"project_title": {
"description": "Project title",
"type": "string"
},
"scope": {
"description": "What is in scope, one bullet each. Omitted from the document if not given or empty",
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"description": "One or two paragraphs on the problem and the approach. Omitted from the document if not given",
"type": "string"
},
"timeline": {
"description": "Phases and their durations, rendered as a table. Omitted from the document if not given or empty",
"items": {
"additionalProperties": false,
"properties": {
"duration": {
"description": "e.g. '2 weeks'",
"type": "string"
},
"phase": {
"type": "string"
}
},
"required": [
"phase",
"duration"
],
"type": "object"
},
"type": "array"
},
"valid_until": {
"description": "YYYY-MM-DD, the date the quote expires",
"type": "string"
}
},
"required": [
"client",
"project_title",
"price"
],
"type": "object"
},
"name": "proposal_create",
"outputSchema": null
},
{
"description": "Rewrite an existing proposal in place from its reference. Only the fields you pass change; the rest comes from the data stored at creation. Returns the fields that changed and the file path.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"client": {
"type": "string"
},
"deliverables": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "number"
},
"currency": {
"pattern": "^[A-Za-z]{3}$",
"type": "string"
},
"terms": {
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
},
"project_title": {
"type": "string"
},
"reference": {
"description": "The proposal reference, e.g. PROP-2026-0001. The same file and the same reference number are kept, so no second document is burned against the free-tier monthly count",
"type": "string"
},
"scope": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": "string"
},
"timeline": {
"items": {
"additionalProperties": false,
"properties": {
"duration": {
"type": "string"
},
"phase": {
"type": "string"
}
},
"required": [
"phase",
"duration"
],
"type": "object"
},
"type": "array"
},
"valid_until": {
"type": "string"
}
},
"required": [
"reference"
],
"type": "object"
},
"name": "proposal_update",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:8f98cf252b58472db6b4c13e8f05dcabcb1bb55f553efbbbab478a3d779c3fcd | sha256sum