Finekot API — MCP server

Remote MCP server and REST API with 89 pay-per-call services for AI agents: screenshots, web scraping, PDF and document processing, OCR, text-to-speech, speech-to-text, image tools, invoice and contract extraction, sanctions screening, validation and developer utilities.

• MCP endpoint (Streamable HTTP): https://api.finekot.com/mcp

• Server card: https://api.finekot.com/.well-known/mcp.json

• OpenAPI: https://api.finekot.com/openapi.json

• Agent docs: https://api.finekot.com/llms.txt

• Pricing and service list: https://api.finekot.com

This repository holds the registry manifest (server.json), the client SDKs and the publishing workflows. The server itself is hosted; there is nothing to install or run locally.

Billing

• One key, flat price per call. Prices start at €0.0002 per call and are listed per service at https://api.finekot.com.

• Charged only on HTTP 200. Errors are free.

• Every response carries X-Cost and X-Balance headers.

• Agents without a key can pay per call with x402 (USDC on Base): POST https://api.finekot.com/x/v1/<service>.

• Playground without a key: POST https://api.finekot.com/v1/try/<service>, 10 calls per day per IP.

• Files are processed in memory on EU servers and returned as a signed URL valid for 24 hours.

Related MCP server: Arch AI Tools

Get a key

curl -X POST https://api.finekot.com/v1/keys \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com"}'

The response contains a key of the form fk_live_… with €1 of free credit. Balance top-up is at https://api.finekot.com.

Connect

The MCP server authenticates with a bearer header. Replace fk_live_… with your key.

Claude Desktop

Settings → Developer → Edit Config, then add to claude_desktop_config.json:

{
  "mcpServers": {
    "finekot": {
      "url": "https://api.finekot.com/mcp",
      "headers": {
        "Authorization": "Bearer fk_live_…"
      }
    }
  }
}

Claude Code

claude mcp add --transport http finekot https://api.finekot.com/mcp \
  --header "Authorization: Bearer fk_live_…"

Or in .mcp.json at the project root:

{
  "mcpServers": {
    "finekot": {
      "type": "http",
      "url": "https://api.finekot.com/mcp",
      "headers": {
        "Authorization": "Bearer fk_live_…"
      }
    }
  }
}

Cursor

Settings → Tools & Integrations → New MCP Server, or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "finekot": {
      "url": "https://api.finekot.com/mcp",
      "headers": {
        "Authorization": "Bearer fk_live_…"
      }
    }
  }
}

Any other MCP client

Transport streamable-http, URL https://api.finekot.com/mcp, header Authorization: Bearer fk_live_…. Each tool returns its cost and the remaining balance.

REST

Every service is also a plain HTTP endpoint: POST https://api.finekot.com/v1/<service> with a JSON body (or multipart for file upload).

curl -X POST https://api.finekot.com/v1/screenshot \
  -H 'Authorization: Bearer fk_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com", "full_page": true}'

Parameters, prices and examples for all 89 services: https://api.finekot.com/llms.txt and https://api.finekot.com/openapi.json.

Services

89 live services, listed below by REST service id. MCP tool names differ for some services (for example remove-bg is the tool remove_background, scrape-md is url_to_markdown); the full tool list is in the server card and in tools/list.

• Web — screenshot, scrape-md, web-answer, news-brief, llms-txt, web-search, seo-audit, seo-meta, change-monitor, link-preview, browser, uptime, domain-health, url-safety

• Images — remove-bg, compress, watermark, qr, barcode, og-image, color-palette, exif-strip, ocr, image-moderate, caption, chart-render, diagram-render

• Documents and PDF — html-pdf, pdf-tools, pdf-text, table-extract, doc-convert, csv-convert, md-convert, docx-gen, pdf-sign, file-type-detect, text-diff

• Audio and video — tts, stt, denoise, subtitles, video-clip

• Text and LLM — summarize, translate, extract-json, classify, rewrite, detect-lang, embed, semantic-search, doc-redact, readability-score, profanity-filter, entity-extract, prompt-guard, memory, lib-docs, paper-search

• Finance and compliance — invoice-parse, e-invoice, bank-statement-parse, purchase-order-extract, invoice-3way-match, contract-clause-extract, resume-parse, sanctions-screen, company-verify, vat-check, iban-validate, fx

• Validation and lookups — email-verify, phone-validate, ip-geo, vin-decode, weather, holidays

• Developer utilities — sql-lint, regex-test, hash, uuid, base64, jwt-tools, cron-explain, math-eval, unit-convert, tz-convert, webhook-relay, mcp-host

SDKs

Thin clients over the REST API. Both live in this repository.

Python — finekot

pip install finekot

from finekot import Finekot

fk = Finekot("fk_live_…")
result = fk.call("screenshot", url="https://example.com", full_page=True)
print(result["url"], fk.cost, fk.balance)

Source: sdk/python.

Node — finekot-api

npm install finekot-api

import { Finekot } from "finekot-api";

const fk = new Finekot("fk_live_…");
const result = await fk.call("screenshot", { url: "https://example.com", full_page: true });
console.log(result.url, fk.cost, fk.balance);

Source: sdk/node.

Registry

server.json follows the official MCP Registry schema (2025-12-11). The publish-mcp.yml workflow publishes it to https://registry.modelcontextprotocol.io on every v* tag using GitHub OIDC.

License

MIT. See LICENSE. The hosted service is subject to the terms at https://api.finekot.com.