MCP MeasureMCP Measure

index observed

Compabase

3M+ Polish companies (KRS, CEIDG): financials, people, rankings and public registries.

Should I use this

Quality & Safety

A
Description quality
98%
Schema completeness
86%
Naming quality
98%
Poisoning risk
100%
Permission match
80%
Protocol compliance
100%

Findings (7)

  • LOWTool 'get_company_financial_supervision' description lacks action verbin get_company_financial_supervision
  • LOWTool 'get_company_procurement_disputes' name length outside 3-30 rangein get_company_procurement_disputes
  • LOWTool 'get_company_financial_supervision' name length outside 3-30 rangein get_company_financial_supervision
  • LOWTool 'get_company_procurement_counterparties' name length outside 3-30 rangein get_company_procurement_counterparties
  • LOWTool 'get_company_secured_liabilities' name length outside 3-30 rangein get_company_secured_liabilities
  • LOWTool 'get_company_website_facts' suggests web access but openWorldHint=falsein get_company_website_facts
  • LOWTool 'set_webhook_url' suggests web access but openWorldHint=falsein set_webhook_url

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~11,399Tokens (tool definitions)
~1.2 KBTypical response size
Significant attention impact (8.91% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "compabase": {
      "url": "https://compabase.com/api/mcp"
    }
  }
}

Remote endpoints

https://compabase.com/api/mcpstreamable-http

What it can do

Tool inventory

Tools (54)

🟒 Read-only🟑 WriteπŸ”΄ Deleteβšͺ Unknown
🟒request_signup(email, locale, client)

Start Compabase account setup for an email. Sends a magic link. After the user clicks it, poll check_signup with the returned setup_id until status is ready β€” then you receive an MCP key automatically. Do not ask the user to generate a key in the portal. No auth required.

Input Schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "User email to create or sign in to a Compabase account."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "pl",
        "de"
      ],
      "description": "Email language (default en)."
    },
    "client": {
      "type": "string",
      "enum": [
        "cursor",
        "claude",
        "vscode",
        "other"
      ],
      "description": "AI client, used to label the generated MCP key."
    }
  },
  "required": [
    "email"
  ]
}
🟑check_signup(setup_id, client)

Poll a request_signup session. When the user has confirmed email, returns mcp_key once and cursor_mcp_json to write to MCP config. Call every 3 seconds until status is ready, expired, or already_delivered. No auth required.

Input Schema

{
  "type": "object",
  "properties": {
    "setup_id": {
      "type": "string",
      "description": "setup_id from request_signup."
    },
    "client": {
      "type": "string",
      "enum": [
        "cursor",
        "claude",
        "vscode",
        "other"
      ],
      "description": "Optional client hint for the key name."
    }
  },
  "required": [
    "setup_id"
  ]
}
🟒list_plans

List Compabase billing plans and limits. No auth required. After sign-up, use upgrade_plan to get a Stripe Checkout URL.

Input Schema

{
  "type": "object",
  "properties": {}
}
🟒search_companies(name, krs, nip, city, county, ...)

Search and filter Polish KRS companies (spΓ³Ε‚ki). Compabase also holds the full CEIDG/JDG register; this tool does not browse JDG β€” those without a public contact email are hidden because of RODO. Default `fields=summary` returns a compact row (name, NIP, KRS, location, PKD, latest financials, email/phone/website) β€” small enough for MCP clients. `fields=contacts_only` is name/NIP/KRS/city/email/phone/website only. `fields=full` returns every company_search column plus contacts and may exceed client size limits. Use for rankings, sector filters, city/county/region browsing, name search, or NIP/KRS lookup. When a PKD is mostly JDG, a sparse result includes a `hint` (full CEIDG is in the database; listing is RODO-gated). Do not call export_companies just to get a handful of emails or phones.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (10 digits, zero-padded, e.g. '0000028860')."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (10 digits, no dashes)."
    },
    "city": {
      "type": "string",
      "description": "City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase)."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'."
    },
    "postal_code": {
      "type": "string",
      "description": "Postal code prefix, e.g. '00-9' or '61-'."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "legal_form": {
      "type": "string",
      "description": "Legal form fragment, e.g. 'spΓ³Ε‚ka z o.o.' or 'akcyjna'."
    },
    "currency": {
      "type": "string",
      "enum": [
        "pln",
        "usd",
        "eur"
      ],
      "description": "Currency for monetary filters. Default: pln."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue."
    },
    "profit_min": {
      "type": "number",
      "description": "Minimum net profit."
    },
    "profit_max": {
      "type": "number",
      "description": "Maximum net profit."
    },
    "profit_operating_min": {
      "type": "number",
      "description": "Minimum operating profit (PLN). Negative allowed. Omit if unused."
    },
    "profit_operating_max": {
      "type": "number",
      "description": "Maximum operating profit (PLN). Omit if unused."
    },
    "total_assets_min": {
      "type": "number",
      "description": "Minimum total assets."
    },
    "total_assets_max": {
      "type": "number",
      "description": "Maximum total assets."
    },
    "ebitda_min": {
      "type": "number",
      "description": "Minimum EBITDA."
    },
    "ebitda_max": {
      "type": "number",
      "description": "Maximum EBITDA."
    },
    "capital_min": {
      "type": "number",
      "description": "Minimum share capital."
    },
    "capital_max": {
      "type": "number",
      "description": "Maximum share capital."
    },
    "estimated_value_min": {
      "type": "number",
      "description": "Minimum Ohlson estimated equity value in PLN."
    },
    "estimated_value_max": {
      "type": "number",
      "description": "Maximum Ohlson estimated equity value in PLN."
    },
    "registration_date_min": {
      "type": "string",
      "description": "Earliest KRS registration date, YYYY-MM-DD (inclusive). For newly registered companies use today's date for both registration_date_min and registration_date_max."
    },
    "registration_date_max": {
      "type": "string",
      "description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active only, false = closed only. Omit for all."
    },
    "has_email": {
      "type": "boolean",
      "description": "true = only companies with email on record. Matching rows include contacts.email. Omit otherwise."
    },
    "has_website": {
      "type": "boolean",
      "description": "true = only companies with website on record. Matching rows include contacts.website. Omit otherwise."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "revenue_total",
        "profit_net",
        "total_assets",
        "profit_operating",
        "ebitda",
        "capital_total",
        "estimated_value",
        "registration_date",
        "revenue_growth_pct"
      ],
      "description": "Sort field (default: revenue_total). registration_date + sort_dir=desc lists the newest registrations first. revenue_growth_pct + sort_dir=desc lists the fastest-growing companies (y/y revenue growth from KRS financial statements; combine with revenue_min to skip small companies)."
    },
    "sort_dir": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort direction (default: desc)."
    },
    "year": {
      "type": "integer",
      "description": "Filter to companies whose latest financial_period_to falls within this calendar year (e.g. 2024). Use only for sector/ranking browse β€” omit when looking up a company by name, KRS, or NIP."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default: 10, max: 50)."
    },
    "fields": {
      "type": "string",
      "enum": [
        "contacts_only",
        "summary",
        "full"
      ],
      "description": "Response size. Default summary (name, NIP, KRS, location, PKD, latest financials, email/phone/website). contacts_only: name, NIP, KRS, city, email, phone, website. full: every company_search column plus contacts β€” often too large for MCP clients."
    }
  }
}
🟒get_company(name, krs, nip)

Get company registry profile and headline financials for one latest filed period (`financials.period_to` / `financial_period_to`): revenue, profit, costs, assets, estimated_value (Ohlson/RIM equity estimate), PKD, address, plus contacts when on record, full address, share capital, representation, recent KRS changes and `vat` (MF white list: VAT status, VAT registration date, bank accounts, removal/restoration, date Compabase checked it). All money fields in this response are that same period β€” there is no nested summary from a different year. NIP lookup also returns a CEIDG/JDG firm when it has a public contact email (RODO). Does NOT include balance-sheet line items (cash, receivables, inventories). For those or earlier years, use get_financials.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (10 digits, zero-padded)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (10 digits, dashes optional)."
    }
  }
}
🟒get_financials(name, krs, nip, year_from, year_to)

Get full financial statement metrics per fiscal period β€” all entity_financial_metrics columns. Includes cash_and_equivalents, inventories, receivables, liabilities, equity, cost breakdown, revenue lines. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number."
    },
    "year_from": {
      "type": "integer",
      "description": "Earliest fiscal year to include (e.g. 2019)."
    },
    "year_to": {
      "type": "integer",
      "description": "Latest fiscal year to include (e.g. 2023)."
    }
  }
}
🟒get_company_people(name, krs, nip, relationship_type)

Get people associated with a company β€” management board, supervisory board, shareholders, proxies. Returns display names, role labels, and relationship types (management, supervisory, ownership, procuration). Identify by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number."
    },
    "relationship_type": {
      "type": "string",
      "description": "Filter: management, supervisory (rada nadzorcza), ownership, procuration. Omit for all."
    }
  }
}
🟒count_companies(name, krs, nip, city, county, ...)

Count KRS companies matching given filters. Returns a single number β€” no company list. Does not count JDG in this tool (full CEIDG is in Compabase; listing is RODO-gated). Sparse or zero counts in JDG-dominated PKDs include a `hint`.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number."
    },
    "city": {
      "type": "string",
      "description": "City name β€” KRS uses uppercase."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase)."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (lowercase)."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "legal_form": {
      "type": "string",
      "description": "Legal form fragment."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue in PLN."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue in PLN."
    },
    "profit_min": {
      "type": "number",
      "description": "Minimum net profit in PLN."
    },
    "profit_max": {
      "type": "number",
      "description": "Maximum net profit in PLN."
    },
    "profit_operating_min": {
      "type": "number",
      "description": "Minimum operating profit in PLN."
    },
    "profit_operating_max": {
      "type": "number",
      "description": "Maximum operating profit in PLN."
    },
    "total_assets_min": {
      "type": "number",
      "description": "Minimum total assets in PLN."
    },
    "total_assets_max": {
      "type": "number",
      "description": "Maximum total assets in PLN."
    },
    "ebitda_min": {
      "type": "number",
      "description": "Minimum EBITDA in PLN."
    },
    "ebitda_max": {
      "type": "number",
      "description": "Maximum EBITDA in PLN."
    },
    "capital_min": {
      "type": "number",
      "description": "Minimum share capital in PLN."
    },
    "capital_max": {
      "type": "number",
      "description": "Maximum share capital in PLN."
    },
    "estimated_value_min": {
      "type": "number",
      "description": "Minimum Ohlson estimated equity value in PLN."
    },
    "estimated_value_max": {
      "type": "number",
      "description": "Maximum Ohlson estimated equity value in PLN."
    },
    "registration_date_min": {
      "type": "string",
      "description": "Earliest KRS registration date, YYYY-MM-DD (inclusive). For newly registered companies use today's date for both registration_date_min and registration_date_max."
    },
    "registration_date_max": {
      "type": "string",
      "description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active only, false = closed only. Omit for all."
    },
    "has_email": {
      "type": "boolean",
      "description": "true = only companies with email on record. Omit otherwise."
    },
    "has_website": {
      "type": "boolean",
      "description": "true = only companies with website on record. Omit otherwise."
    },
    "year": {
      "type": "integer",
      "description": "Filter to companies whose latest financial_period_to falls within this calendar year. Use only for sector/ranking browse β€” omit when looking up a company by name, KRS, or NIP."
    }
  }
}
🟒execute_sql(query)

Execute a read-only SQL SELECT query against the Compabase database. Use when dedicated tools are not enough (aggregations, joins, custom analysis). Returns at most row_limit rows per call depending on the plan (Free 100, Pro 500, Scale 1000); if truncated is true, aggregate inside SQL (GROUP BY, COUNT, AVG, percentile_cont) instead of listing raw rows.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "A read-only SQL SELECT or WITH…SELECT statement."
    }
  },
  "required": [
    "query"
  ]
}
🟒get_company_rankings(name, krs, nip, scope_type)

Get a company's revenue rank positions within its industry (PKD), region (voivodeship), and all of Poland. Returns rows from company_financial_rankings β€” one row per scope (pkd_full, pkd_division, pkd_section, region, country). PKD scope keys of historical classifications are prefixed with the version: 'v2007:62.01.Z', 'v2004:50', 'v1997:74.84.B' (no prefix = PKD 2025). Use for questions like: where does company X rank in Poland / its industry / its region?

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (10 digits, zero-padded)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (10 digits, dashes optional)."
    },
    "scope_type": {
      "type": "string",
      "enum": [
        "pkd_full",
        "pkd_division",
        "pkd_section",
        "region",
        "country"
      ],
      "description": "Optional. Filter to a single scope. Omit to get all scopes."
    }
  }
}
🟒get_financial_stats(dimension_type, dimension_key, metric, currency)

Get precomputed aggregate financial statistics for a sector, region, PKD branch, or country. Returns median, p25/p75/p90, winsorized mean, mean, total, n_companies, min/max. Use for questions like: what is the median revenue / average profit / assets in industry X or region Y? Prefer median or winsor_mean over mean. cost_wages is PLN-only.

Input Schema

{
  "type": "object",
  "properties": {
    "dimension_type": {
      "type": "string",
      "enum": [
        "country",
        "pkd_section",
        "pkd_division",
        "pkd_class",
        "pkd_full",
        "region",
        "county",
        "city"
      ],
      "description": "Granularity: 'country'=Poland; 'pkd_section'=A–U; 'pkd_division'=2-digit; 'pkd_full'=full code; 'region'=voivodeship; etc."
    },
    "dimension_key": {
      "type": "string",
      "description": "Key for the dimension, e.g. 'PL', 'G', '46', '46.90.Z', 'mazowieckie'. Prefix match applied."
    },
    "metric": {
      "type": "string",
      "enum": [
        "revenue_total",
        "profit_net",
        "total_assets",
        "cost_wages"
      ],
      "description": "Financial metric. Omit to return all metrics."
    },
    "currency": {
      "type": "string",
      "enum": [
        "PLN",
        "EUR",
        "USD"
      ],
      "description": "Currency (default: PLN). cost_wages is PLN-only."
    }
  }
}
🟒get_company_public_aid(name, krs, nip)

Get SUDOP public aid / grants for a company β€” full case list with amounts, grantor, measure, purpose. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for SUDOP)."
    }
  }
}
🟒get_company_eu_funds(name, krs, nip)

Get European Funds (Fundusze Europejskie) projects for a company β€” official MFiPR lists, EU co-financing, programme and dates. Keyed by NIP. Identify company by name, KRS, or NIP. Cohesion/shared-management funds; not TED procurement, not FTS Commission grants, and not SUDOP state aid.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for FE)."
    }
  }
}
🟒get_company_procurement(name, krs, nip)

Get European Commission FTS awards for a company β€” Horizon, LIFE, Erasmus and other direct/indirect-management grants. Keyed by NIP (VAT). Identify by name, KRS, or NIP. Not cohesion funds (get_company_fe) and not TED procurement.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for FTS)."
    }
  }
}
🟒get_company_public_tenders(name, krs, nip)

Get BZP public procurement data β€” full awards as contractor and notices as buyer, with award values. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for BZP)."
    }
  }
}
🟒get_company_energy_licenses(name, krs, nip)

Get URE energy concessions for a company β€” full list of electricity, gas, heat, and liquid fuels, with validity dates and pending applications. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for URE)."
    }
  }
}
🟒get_company_public_contracts(name, krs, nip)

Get contracts from Poland's Central Register of Contracts (CRU JSFP, Ministry of Finance) where the company is the contractor of a public-sector unit (ministries, municipalities, schools, hospitals) β€” count, total value, top public buyers and the 50 most recent contracts (date, subject, value in PLN, buyer, link). Register live since July 2026; covers contracts below tender thresholds too. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for CRU)."
    }
  }
}
🟒get_company_nfz_contracts(name, krs, nip)

Get contracts between the company (as a healthcare provider) and Poland's National Health Fund (NFZ) β€” value of NFZ contracts in the latest year and every year since 2008, types of care (hospital, outpatient, dental, rehabilitation, pharmacy etc.) with NFZ regional branch, and the largest contracts. Amounts are annual contract values in PLN. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for NFZ)."
    }
  }
}
🟒get_company_nfz_queues(name, krs, nip, service, town, ...)

Get NFZ (National Health Fund) waiting lists of a healthcare provider β€” every NFZ-funded service (specialist clinics, diagnostics such as MRI/CT, procedures, rehabilitation, hospital wards) it runs a waiting list for, per location: NFZ forecast waiting time for stable and urgent cases, people waiting, average wait, address, phone, whether children are seen and accessibility. Sorted by shortest wait. Optional filters: service (e.g. 'okulist', 'rezonans') and town. Data from the NFZ 'Terminy leczenia' API; the forecast is not a booking. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for NFZ)."
    },
    "service": {
      "type": "string",
      "description": "Optional filter: fragment of the service name, e.g. 'okulist', 'ortoped', 'rezonans'."
    },
    "town": {
      "type": "string",
      "description": "Optional filter: town or district, e.g. 'PoznaΕ„'."
    },
    "limit": {
      "type": "integer",
      "description": "Max rows (default 50, max 400)."
    }
  }
}
🟒get_company_trademarks(name, krs, nip)

Get Polish Patent Office (UPRP) trademarks owned or applied for by the company β€” mark name, application number, Nice classes, status (protected / pending / expired / refused), filing, registration and expiry dates, plus counts. Owners are matched by company name and city (UPRP does not publish NIP). Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred)."
    }
  }
}
🟒get_company_procurement_disputes(name, krs, nip)

Get National Appeal Chamber (Krajowa Izba OdwoΕ‚awcza, KIO) rulings in public procurement disputes involving the company β€” as appellant (with upheld / dismissed / discontinued / rejected counts), as participant or as contracting authority β€” with case numbers, dates, other party and outcome. Parties are matched by name and city. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred)."
    }
  }
}
🟒get_company_waste_registry(name, krs, nip)

Get BDO waste and packaging register data β€” registration number, EUP site count, activity flags, and headquarters decisions with issue and validity dates. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for BDO)."
    }
  }
}
🟒get_company_stock_market(name, krs, nip)

Get Warsaw Stock Exchange listing for a company β€” ticker, ISIN, market (GPW main / NewConnect / GlobalConnect), last close and change, market cap, shares outstanding, TTM EPS, TTM P/E (falls back to last annual filing), last quarterly results, next earnings date, dividend per share and yield. Quotes delayed ~15 minutes, in PLN. Snapshot plus a few recent daily bars β€” not full OHLCV history. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for GPW)."
    }
  }
}
🟒get_company_eu_tenders(name, krs, nip)

Get TED EU-threshold public procurement β€” full awards as contractor and notices as buyer. Keyed by NIP. Identify company by name, KRS, or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for TED)."
    }
  }
}
🟒get_company_court_gazette(name, krs, nip)

Get Court and Commercial Gazette (MSiG) notices for one company. Matched by KRS or NIP (creditor calls, dissolution, mergers, liquidation).

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP (CEIDG / when KRS unknown)."
    }
  }
}
🟒get_company_sanctions(name, krs, nip)

Official MSWiA sanctions listing for one company. Returns measures and legal grounds when the company is listed; null when it is not. Matched by KRS, NIP, or REGON. The same payload is included on get_company as sanctions.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number."
    }
  }
}
🟒get_company_debt_registry(name, krs, nip)

Get KRZ insolvency / restructuring proceedings. KRS companies via company_krz; sole proprietors via CEIDG KRZ by NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP (CEIDG / when KRS unknown)."
    }
  }
}
🟒get_company_financial_supervision(name, krs, nip)

KNF register (Polish Financial Supervision Authority): licences and entries of a financial company β€” banks, payment / e-money institutions, investment firms, insurers, lending institutions, agents. Returns entries with kind, KNF number, status, registration / decision / strike-off dates and services. Keyed by NIP; null when the company has no KNF entry.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}
🟒get_company_website_facts(name, krs, nip)

Facts read from the company's own website: opening hours (per weekday), branches/locations with addresses, offer (CPV divisions plus short product/service names in PL/EN/DE), certifications found on the site (ISO 9001, HACCP, FSC…), website technology (CMS, e-commerce platform, payments, analytics) and clients/partners linked from the site that match KRS companies. Keyed by KRS or NIP (sole proprietors with a public profile); null when the website has not been read or shows none of these.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}
🟒get_company_procurement_counterparties(name, krs, nip)

Public procurement counterparties of a company from BZP, TED and CRU: the buyers it most often wins contracts from, the contractors it most often awards contracts to, and its consortium partners β€” each with KRS (when known), number of contracts, total value (PLN/EUR/USD) and years. Top 20 per role plus totals. Keyed by NIP/KRS; null when the company has no public procurement.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}
🟒get_company_filing_timeliness(name, krs, nip)

Financial statement filing timeliness from KRS register entries (date each annual statement was filed) and the Financial Document Repository: for each recent financial year the period end, filing date, statutory deadline (year end + 6 months + 15 days), days late or not filed, and whether a statutory auditor's report was filed. Also overdue_year when the latest statement is past its deadline and missing, and late_last_5y. Keyed by KRS; null when the company has never filed.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}
🟒get_company_secured_liabilities(name, krs, nip)

Secured liabilities from the latest financial-statement notes (period ending 2025+): mortgages (hipoteki), registered / financial pledges (zastawy), transfers of ownership, assignments β€” with creditor, amount, secured debt, asset and land-register (KW) numbers. Keyed by KRS; null when nothing is disclosed.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}
🟒get_company_real_estate(name, krs, nip)

Company real estate from the latest financial statement (period ending 2025+): land incl. perpetual usufruct, buildings and premises, investment property (book values in PLN/EUR/USD) plus property locations named as mortgage collateral (address, land-register KW numbers, creditor). Keyed by KRS; null when the balance sheet shows no real estate (micro and small entities have no such breakdown).

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}
🟒get_company_beneficiaries(name, krs, nip)

Get CRBR beneficial owners for a KRS company. All names are returned (same as zarzΔ…d / wspΓ³lnicy). PESEL is never included (birth_year only). JDG are not in CRBR.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (required path for CRBR)."
    },
    "nip": {
      "type": "string",
      "description": "NIP β€” used to resolve KRS when needed."
    }
  }
}
🟒get_company_articles(name, krs, nip, doc_id)

Get full text of the company's articles of association or statute (umowa spΓ³Ε‚ki / statut) from RAR (Repozytorium Akt Rejestrowych). Use when the user asks about: share transfer consent, preemption rights, non-compete clauses, company duration, voting rights, special share classes, representation rules from the deed, or any clause in the founding document. Returns doc metadata + full extracted text. KRS companies only.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP β€” used to resolve KRS when needed."
    },
    "doc_id": {
      "type": "string",
      "description": "Optional: specific rar_doc_id. Omit for the latest articles / statute."
    }
  }
}
🟒get_usage

Get current billing period usage and remaining quota β€” mcp_queries, api_requests, export_companies, ask_ai_credits, watchlist_companies. Includes limits and reset date.

Input Schema

{
  "type": "object",
  "properties": {}
}
🟒get_plan

Get the user's active billing plan details β€” plan name, price, status, limits, prepaid credit balance, and billing period reset date.

Input Schema

{
  "type": "object",
  "properties": {}
}
🟒list_watchlist(limit, offset)

List companies on the user's watchlist with company data (name, KRS, NIP, revenue, city). Supports pagination via limit/offset.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max results (default: 20, max: 100)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset (default: 0)."
    }
  }
}
🟑add_to_watchlist(krs, nip)

Add a company to the user's watchlist. Identify by KRS (10-digit) or NIP (10-digit). Supports both KRS companies and CEIDG sole proprietorships (via NIP).

Input Schema

{
  "type": "object",
  "properties": {
    "krs": {
      "type": "string",
      "description": "KRS registry number (10 digits, zero-padded)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (10 digits). Used for CEIDG if no KRS match."
    }
  }
}
πŸ”΄remove_from_watchlist(krs, nip)

Remove a company from the user's watchlist. Identify by KRS or NIP.

Input Schema

{
  "type": "object",
  "properties": {
    "krs": {
      "type": "string",
      "description": "KRS registry number (10 digits, zero-padded)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (10 digits)."
    }
  }
}
🟒list_api_keys

List all active REST API keys (cb_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.

Input Schema

{
  "type": "object",
  "properties": {}
}
🟑create_api_key(name)

Create a new REST API key (cb_…). The raw key is returned once and cannot be retrieved later.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable label for the key (max 100 chars)."
    }
  },
  "required": [
    "name"
  ]
}
πŸ”΄delete_api_key(key_id)

Revoke (deactivate) a REST API key by its ID. The key stops working immediately.

Input Schema

{
  "type": "object",
  "properties": {
    "key_id": {
      "type": "string",
      "description": "UUID of the API key to revoke (from list_api_keys)."
    }
  },
  "required": [
    "key_id"
  ]
}
🟒list_mcp_keys

List all active MCP keys (mcpk_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.

Input Schema

{
  "type": "object",
  "properties": {}
}
🟑create_mcp_key(name)

Create a new MCP key (mcpk_…). The raw key is returned once and cannot be retrieved later.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable label for the key (max 100 chars)."
    }
  },
  "required": [
    "name"
  ]
}
πŸ”΄delete_mcp_key(key_id)

Revoke (deactivate) an MCP key by its ID. Cannot revoke the key currently in use. The key stops working immediately.

Input Schema

{
  "type": "object",
  "properties": {
    "key_id": {
      "type": "string",
      "description": "UUID of the MCP key to revoke (from list_mcp_keys)."
    }
  },
  "required": [
    "key_id"
  ]
}
🟒export_companies(name, krs, nip, city, county, ...)

Bulk file export of companies matching filters (CSV / XLSX / JSON). Up to 500 rows per call. Default `fields=contacts_only`: name, NIP, KRS, city, email, phone, website β€” small enough to use in-chat. `fields=summary` adds location, PKD, latest revenue/profit. `fields=full` is the complete dump (change history, rankings, people, enrichments, CSV twins) and often exceeds MCP client limits. Consumes export quota only after the file is built successfully. For a short list of emails after search_companies, use search with fields=contacts_only instead.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name fragment (case-insensitive)."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (exports that one company)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (exports matching companies)."
    },
    "city": {
      "type": "string",
      "description": "City name."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase). Same filter as search_companies / count_companies."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (e.g. mazowieckie)."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '80.10', '80.10.Z', or '80' (same prefix matching as search_companies)."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active companies only."
    },
    "format": {
      "type": "string",
      "enum": [
        "csv",
        "xlsx",
        "json"
      ],
      "description": "Export format (default: csv). Column set follows `fields` (contacts_only by default)."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "pl",
        "de"
      ],
      "description": "Column/label language (default: en)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Max rows to export (default: 50, max: 500)."
    },
    "fields": {
      "type": "string",
      "enum": [
        "contacts_only",
        "summary",
        "full"
      ],
      "description": "Payload size. Default contacts_only (name, NIP, KRS, city, email, phone, website). summary adds county/region, PKD, latest revenue/profit. full is the complete profile dump β€” often too large for MCP clients; use only when asked for the full file."
    }
  }
}
🟑upgrade_plan(plan_id, locale, currency)

Create a Stripe Checkout session for a plan upgrade. Shows current plan and available upgrades. Pass plan_id ('pro' or 'scale') to get a checkout_url on checkout.stripe.com β€” open it in the browser for the user to pay. Do not send the user to the marketing pricing page.

Input Schema

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "enum": [
        "pro",
        "scale"
      ],
      "description": "Target plan ID. Required to create a Stripe Checkout URL."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "pl",
        "de"
      ],
      "description": "UI locale for the success/cancel return URLs (default en)."
    },
    "currency": {
      "type": "string",
      "enum": [
        "PLN",
        "USD",
        "EUR"
      ],
      "description": "Checkout currency. Defaults from locale (pl β†’ PLN, otherwise USD)."
    }
  }
}
πŸ”΄set_webhook_url(action, url, events)

Configure, view, or remove webhook for watchlist event notifications. Events: watchlist.company_changed, watchlist.financials_updated, watchlist.company_removed_from_registry.

Input Schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "set",
        "delete"
      ],
      "description": "Action: 'get' to view config, 'set' to configure, 'delete' to remove."
    },
    "url": {
      "type": "string",
      "description": "HTTPS webhook endpoint URL (required for action=set)."
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Event types to subscribe to. Defaults to all available events."
    }
  },
  "required": [
    "action"
  ]
}
🟒get_byok_keys

List configured Bring-Your-Own-Key (BYOK) provider keys status. Shows which providers (openai, claude, gemini) have keys configured, with prefix and last-used date. Never returns the actual key.

Input Schema

{
  "type": "object",
  "properties": {}
}
🟑set_byok_key(provider, api_key)

Add or update a BYOK provider API key. Key is encrypted at rest (AES-256-GCM). Requires paid plan (Pro+). Providers: openai (sk-…), claude (sk-ant-…), gemini (AIza… or AQ.…).

Input Schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "openai",
        "claude",
        "gemini"
      ],
      "description": "AI provider name."
    },
    "api_key": {
      "type": "string",
      "description": "Raw API key for the provider."
    }
  },
  "required": [
    "provider",
    "api_key"
  ]
}
πŸ”΄delete_byok_key(provider)

Remove a configured BYOK provider key. After removal, the platform falls back to its own model access.

Input Schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "openai",
        "claude",
        "gemini"
      ],
      "description": "Provider to remove key for."
    }
  },
  "required": [
    "provider"
  ]
}
🟑add_watchlist_batch(identifiers)

Add multiple companies to watchlist in one call. Provide an array of KRS/NIP identifiers (max 500). Resolves identifiers to companies, skips duplicates, respects plan limits.

Input Schema

{
  "type": "object",
  "properties": {
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of KRS numbers (10 digits) or NIP numbers (10 digits)."
    }
  },
  "required": [
    "identifiers"
  ]
}
🟑set_notification_preferences(action, email_notifications, notification_email)

Get or update email notification preferences for watchlist changes. When email_notifications=true, you will receive an email whenever a watched company's data changes (registry updates, new financial statements, deregistration, etc.).

Input Schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "set"
      ],
      "description": "'get' returns current preferences, 'set' updates them."
    },
    "email_notifications": {
      "type": "boolean",
      "description": "Enable/disable email notifications for watchlist changes (required for 'set')."
    },
    "notification_email": {
      "type": "string",
      "description": "Override email address for notifications. Omit to use account email."
    }
  },
  "required": [
    "action"
  ]
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded54 tools
verifiedversion not recorded51 tools
verifiedversion not recorded50 tools
verifiedversion not recorded45 tools
verifiedversion not recorded43 tools
verifiedversion not recorded42 tools
verifiedversion not recorded42 tools