protogrid

Search / com.almmity.api/pl-firmy

pl-firmy: Polish company check

R1· needs a key

Verify Polish companies: VAT white list (MF), KRS, VIES, payment audit PDF, monitoring.

v0.3.1 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds api_key.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality85good
Trust96of 100
Uptime, 30 days100%
Latency p50462 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "pl-firmy": {
      "type": "http",
      "url": "https://api.almmity.com/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}
claude mcp add --transport http pl-firmy https://api.almmity.com/mcp --header "Authorization: Bearer ${api_key}"
[mcp_servers.pl-firmy]
url = "https://api.almmity.com/mcp"
bearer_token_env_var = "api_key"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pl-firmy": {
      "type": "remote",
      "url": "https://api.almmity.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:api_key}"
      }
    }
  }
}
{
  "mcpServers": {
    "pl-firmy": {
      "type": "http",
      "url": "https://api.almmity.com/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=pl-firmy&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLmFsbW1pdHkuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke2FwaV9rZXl9In19"
}
{
  "servers": {
    "pl-firmy": {
      "type": "http",
      "url": "https://api.almmity.com/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}
{
  "mcpServers": {
    "pl-firmy": {
      "httpUrl": "https://api.almmity.com/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}
extensions:
  "pl-firmy":
    enabled: true
    name: "pl-firmy"
    type: streamable_http
    uri: "https://api.almmity.com/mcp"
    headers:
      "Authorization": "Bearer ${api_key}"
    timeout: 300

Placeholders to fill from your own secret store: ${api_key}. The registry never accepts secret values.

Quality 85 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene86 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations9 of 9 tools declare readOnlyHint or destructiveHint
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: add_watch (idempotentHint); list_watches (destructiveHint, idempotentHint, openWorldHint); check_vat_whitelist (destructiveHint, idempotentHint); …
  • pass
    tools.token_costabout 1,045 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

9 tools, about 1,045 tokens to load them all · tool set 7513d1ddea25 · checked 2026-10-20 18:38 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 96 / 100

provenance85
liveness100
freshness100
hygiene100

+repository +dns-namespace +website +reachable +uptime-100% +updated-8d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://api.almmity.com/mcp streamable-httpapi_key ${api_key}yes100%462 ms2025-11-252026-10-20

Tools (9)

add_watchStart daily monitoring of a Polish contractor: VAT status changes, whitelisted bank accounts added/removed (incl. the specific accounts you pay to), KRS liquidation/bankruptcy/restructuring. Alerts via webhook and/or e-mail. Re-adding updates the watch.
check_vat_whitelistread-onlyQuery the Ministry of Finance VAT white list. Give nip (and optionally bank_account to verify the account belongs to that NIP on a date), or regon, or bank_account alone to find who owns it.
contractor_due_diligenceread-onlyConcise risk summary for a Polish contractor by NIP: VAT status, whitelisted accounts (optionally verify a given bank account), KRS liquidation/bankruptcy/restructuring flags.
find_companyread-onlyCombine MF white list + KRS into one normalized company profile. Provide one of nip, regon, krs.
get_krs_extractread-onlyCurrent KRS (National Court Register) extract: name, legal form, address, share capital, board & representation, proxies, PKD codes, liquidation/bankruptcy flags.
list_watchesread-onlyList your monitored contractors with last status and recent change events.
payment_audit_reportBefore paying a Polish contractor: verify NIP + bank account on the MF white list for the payment date, check KRS and VIES, and produce a PDF 'proof of due diligence' (MF request IDs, timestamps, findings, SHA-256). Flags the >15 000 PLN rule (art. 117ba OP, MPP).
remove_watchdestructiveRemove a contractor (by NIP) from monitoring.
vies_checkread-onlyValidate an EU VAT number via the European Commission VIES REST API, e.g. PL7740001454, DE811569869.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "com.almmity.api/pl-firmy",
  "title": "pl-firmy: Polish company check",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.almmity.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer {api_key}",
          "isSecret": true,
          "variables": {
            "api_key": {
              "isSecret": true,
              "isRequired": true,
              "description": "pl-firmy API key (plf_...)"
            }
          },
          "isRequired": true,
          "description": "Bearer API key. Free key: https://api.almmity.com/#klucz"
        }
      ]
    }
  ],
  "version": "0.3.1",
  "repository": {
    "url": "https://github.com/mil0s2/pl-firmy-mcp-public",
    "source": "github"
  },
  "websiteUrl": "https://api.almmity.com",
  "description": "Verify Polish companies: VAT white list (MF), KRS, VIES, payment audit PDF, monitoring."
}