Analytics Legends SAP Analytics MCP · Analytics Legends

{
  "name": "search_firms",
  "description": "Search the published Analytics Legends directory of SAP AI & analytics service providers — placement agencies, Big-4 and ESN practices, SAP vendors, platforms and community groups — by country, region (EMEA · AMER · LATAM · APAC · AFRICA), kind, declared SAP module and free text. Returns name, HQ country/city, website, careers URL and a one-line editorial claim. SAP END-CUSTOMER companies are NOT in this directory: they are a separate paid dataset, excluded here by the `is_client` FLAG — not by the `client_enterprise` kind code. The two are different columns, and where a row's flag and its kind label disagree in the SSOT it is the flag that decides what this tool serves, so read the flag's meaning into the answer and not the label's. PAGINATED WITH A KEY (a free one is enough): the whole matched set is reachable — pass `_meta.next_cursor` back as `cursor` with the same filters until it is null. Without a key: first 10 rows only, no cursor. When `query` is set, rows are ordered by how well the NAME matches it (exact, then prefix, then substring), and rows matching only the description come last; without `query` the order is the directory's own quality ranking.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Free-text filter, case-insensitive. EVERY word must appear in the record (substring per word, any order), so a natural-language phrase narrows the answer instead of having to match verbatim."
      },
      "country": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "description": "ISO-3166-1 alpha-2 country code, e.g. DE, FR, CH."
      },
      "region": {
        "type": "string",
        "enum": [
          "EMEA",
          "AMER",
          "LATAM",
          "APAC",
          "AFRICA",
          "GLOBAL"
        ],
        "description": "Region code of the HQ country — the platform's six-value geography: EMEA (Europe AND the Middle East), AMER (North America), LATAM, APAC, AFRICA (its own region, not folded into EMEA), GLOBAL (country unknown). Case-insensitive on input; anything else is refused."
      },
      "kind": {
        "type": "string",
        "enum": [
          "agency_placement",
          "professional_services_big4",
          "professional_services_esn",
          "vendor_sap",
          "vendor_partner",
          "platform_marketplace",
          "community_group",
          "training_institution",
          "client_enterprise",
          "other"
        ],
        "description": "Restrict to one organisation kind. This list is the vocabulary the corpus holds today, not a frontier — call list_firm_kinds for the live one. A malformed code is refused; a well-formed code the corpus does not hold returns no rows. Neither case is silently ignored, and neither widens the result."
      },
      "module": {
        "type": "string",
        "description": "Restrict to organisations with a DECLARED link to one SAP module/product code (UPPERCASE snake_case, e.g. DATASPHERE, BDC, SAC, BW4HANA, S4HANA, JOULE — case-insensitive on input). The declared links are structured data, far more selective than free text: `count_firms_by {by:\"module\"}` gives the live vocabulary with counts. A minority of the directory declares any module at all, so this filter finds the DECLARED specialists — absence from the result means no declared link, never that the firm does not work on the module."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response's `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "kind": {
              "type": [
                "string",
                "null"
              ]
            },
            "kind_label": {
              "type": [
                "string",
                "null"
              ]
            },
            "hq_country": {
              "type": [
                "string",
                "null"
              ]
            },
            "hq_city": {
              "type": [
                "string",
                "null"
              ]
            },
            "region": {
              "type": [
                "string",
                "null"
              ]
            },
            "website": {
              "type": [
                "string",
                "null"
              ]
            },
            "jobs_url": {
              "type": [
                "string",
                "null"
              ]
            },
            "claim": {
              "type": [
                "string",
                "null"
              ]
            },
            "size_bracket": {
              "type": [
                "string",
                "null"
              ]
            },
            "founded_year": {
              "type": [
                "integer",
                "null"
              ]
            },
            "sap_signal_band": {
              "type": [
                "string",
                "null"
              ]
            },
            "last_verified_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "count_firms_by",
  "description": "Answer a COUNTING question about the published firm directory in one call: how many organisations per country, per REGION (the six-value geography), per kind, per declared SAP module, or per SAP signal band — with the same `country`/`kind`/`module`/`query` filters `search_firms` takes, so you can count a slice as easily as the whole. Use this instead of paging `search_firms` and tallying rows: the directory holds thousands of organisations, and reading them all to produce a table of counts costs hundreds of calls and megabytes of rows for numbers Postgres computes in one scan. Every bucket is a value the directory actually stores; `value: null` is a real bucket meaning the field is unknown for those rows, and it is served rather than hidden — a country table that silently drops the rows with no country adds up to less than the population and says nothing about it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "by": {
        "type": "string",
        "enum": [
          "country",
          "region",
          "kind",
          "module",
          "sap_signal_band"
        ],
        "description": "Which facet to count on. Required — there is no default worth guessing."
      },
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Free-text filter, case-insensitive. EVERY word must appear in the record (substring per word, any order), so a natural-language phrase narrows the answer instead of having to match verbatim."
      },
      "country": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "description": "ISO-3166-1 alpha-2 country code, e.g. DE, FR, CH."
      },
      "region": {
        "type": "string",
        "enum": [
          "EMEA",
          "AMER",
          "LATAM",
          "APAC",
          "AFRICA",
          "GLOBAL"
        ],
        "description": "Region code of the HQ country — the platform's six-value geography: EMEA (Europe AND the Middle East), AMER (North America), LATAM, APAC, AFRICA (its own region, not folded into EMEA), GLOBAL (country unknown). Case-insensitive on input; anything else is refused."
      },
      "kind": {
        "type": "string",
        "description": "Restrict to one organisation kind before counting, same vocabulary as search_firms. Combining it with `by:\"kind\"` is legal and returns that single bucket."
      },
      "module": {
        "type": "string",
        "description": "Restrict to organisations with a DECLARED link to one SAP module code before counting, same vocabulary as search_firms' `module`. Combining it with `by:\"module\"` is legal and returns that single bucket (plus the null bucket)."
      }
    },
    "required": [
      "by"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": [
                "string",
                "null"
              ]
            },
            "n": {
              "type": [
                "integer",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "get_firm",
  "description": "Fetch one organisation from the published directory by its database slug (`rows[].slug` from search_firms, verbatim). Returns the same public fields plus `partnerships_declared`, the count of partnerships this directory records for the firm — 0 on ~77 % of rows (re-measured 2026-09-30 on the published tranche: 77,1 %; it read ~97 % until the 2026-09-30 brand-family pass derived 3 730 sibling links from sister entities), meaning none recorded here, never that the firm has no partners; a `sibling` link is a reading of shared brand, not a declared org chart. Does not return the paid firm-intelligence profile, contacts, or any person.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "The DATABASE slug, taken verbatim from search_firms.rows[].slug. It is not always the web slug in citation_url: a minority of published rows carry a numeric firm id instead (365 of them on 2026-08-09 — the population is read at query time and returned as `_meta.tranche_total_row_count`, never written down here). get_firm{slug:\"00393\"} is GULP, whose page is /companies/gulp/. Deriving a slug from the citation URL fails on those rows, and deriving it from the NAME is not safe either; carry rows[].slug across instead. A slug this tool refuses is not proof the firm is absent from the market or even from the database — the published tranche is an editorial subset, and a row the editor has not published is refused here exactly as a wrong slug is."
      }
    },
    "required": [
      "slug"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "list_firm_kinds",
  "description": "Breakdown of the published firm directory by organisation kind, with a live row count per kind. Use this before search_firms to know what the population actually is instead of guessing.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "kind": {
              "type": [
                "string",
                "null"
              ]
            },
            "label": {
              "type": [
                "string",
                "null"
              ]
            },
            "n": {
              "type": [
                "integer",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "list_freelance_platforms",
  "description": "The subset of the published directory where a consultant can CREATE A PROFILE — freelance marketplaces, job boards with candidate profiles, talent platforms and expert networks — each with its signup URL, an editorial confidence grade and the date it was assessed. This answers the entering-contractor's first practical question ('where do I register?') in one call. Everything here is also in search_firms — this tool adds the platform fields and the filter, never a wider population. `signup_url` is the platform's own page: it was verified on `assessed_at`, and a platform absent here is not proven to refuse signups — it is unassessed or unpublished.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "country": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "description": "ISO-3166-1 alpha-2 country code, e.g. DE, FR, CH."
      },
      "platform_type": {
        "type": "string",
        "description": "Restrict to one platform type, lowercase snake_case. The live vocabulary with counts is `_meta.available_platform_types` on every response — a well-formed unknown value returns no rows, it never widens the result."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response's `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "platform_type": {
              "type": [
                "string",
                "null"
              ]
            },
            "signup_url": {
              "type": [
                "string",
                "null"
              ],
              "description": "The platform's own signup/profile-creation page, verified on assessed_at."
            },
            "hq_country": {
              "type": [
                "string",
                "null"
              ]
            },
            "confidence": {
              "type": [
                "string",
                "null"
              ],
              "description": "Editorial confidence in the signup assessment."
            },
            "assessed_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "find_opportunities",
  "description": "Search every SAP contract and permanent-role posting Analytics Legends publishes to an ANONYMOUS visitor. Only the SITE RADAR leg below is the population a human browses on /opportunities/, where each of its postings has its own prerendered page; the PROMOTED leg is served to agents only — it is not listed on /opportunities/ and its rows have no page of their own (citation_scope \"section_hub\"). It merges the platform's TWO public legs, which are near-disjoint (measured 2026-07-30: 1 row in common): (a) the PROMOTED feed (`public.public_opportunities`) — general SAP work (FI/CO, SD, EWM, MDG, BTP, ABAP), all German cities, dated (posted_at is populated on all but a few % of the live rows of that leg — the undated rows are sorted LAST and paginate like the others). 🔴 THIS LEG CHANGED SHAPE ON 2026-08-28: until then it was fed by three keyless APIs and carried no contract_type, country_code, expires_at or rate at all; it was then loaded from the site radar and now declares contract_type and country_code on most of its rows, an expiry on most, and an advertised rate on a small minority. Do NOT assume a field is null on this leg — read the `_meta` counters on YOUR OWN response, which are computed at query time; (b) the SITE RADAR (`/api/contracts-lean.json`) — these carry country, category, seniority, posted_at, `employment_type` and, on most of them, `expires_at`; they are the analytics-specific ones (SAC Planning, Datasphere Technical Lead, Business Data Cloud). READ `employment_type` BEFORE CALLING THIS A CONTRACT MARKET: the radar is mostly PERMANENT roles, so an unfiltered page answers a freelance question with salaried jobs unless you filter. The argument of the same name does the filtering, and `_meta.tranche_total_row_count` on your own response is the live population — read the split from a filtered call, never from a figure quoted in this text. TWO DIFFERENT RATE FIELDS, AND THEY MEAN DIFFERENT THINGS. `currency` / `daily_rate_min` / `daily_rate_max` are the posting's OWN advertised rate and are almost always null — most listings publish no rate at all. `rate_band` is the platform's editorial benchmark for that posting's (seniority × product × region) cell. It is a SUBSCRIBER surface of the WEBSITE, not of this server: the radar file this server reads carries no band since 2026-08-29, so `rate_band` is null on EVERY row here, with or without a key (each response's `_meta.rate_band_coverage` counts it). The panel grid itself covers European cells only — DACH, FR/Benelux, UK/IE, Southern EU, Eastern EU, Nordics — so a posting in the Americas, APAC, Africa or the Middle East has no band at ANY tier: never promise one for it. It is `rate_basis: \"panel_inferred\"` — Eursap n=312 plus the Analytics Legends operator panel, permanent rows restated as a TJM equivalent at ~220 billable days a year — NOT a rate this employer offered. Quote it as a band with its `basis`, `kind` and `source`, never as the posting's rate, and never average bands across postings: many rows share one cell. WHAT IS GATED IS A FIELD, NOT A ROW: on most radar rows `source_url` is null and `application_link` reads \"members_only\" — the verified link to the original listing is the paid Consultant-tier deliverable. Everything else about the posting is public, and `citation_url` is that posting's own page on analyticslegends.ai. Quote it. Report `_meta.tranche_row_count` as the published public population, never as the size of the market.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Free-text filter, case-insensitive. EVERY word must appear in the record (substring per word, any order), so a natural-language phrase narrows the answer instead of having to match verbatim."
      },
      "location": {
        "type": "string",
        "description": "City or place, matched case-insensitively as a substring of the posting's location. The promoted leg is all-German (Hamburg, Frankfurt am Main, Bremen, Munich, Cologne, Dortmund, Hanover, Landshut, Mannheim, Stuttgart); the site-radar leg is worldwide."
      },
      "country": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "description": "ISO-3166-1 alpha-2 code, applied to both legs as a predicate on the row's own country_code. It NO LONGER selects the site-radar leg alone: the promoted feed carried country_code on almost none of its rows until 2026-08-28 and now carries it on most, so a country filter now returns both legs. A row still without one is dropped because it does not match, not because its leg was excluded by assumption. `_meta.match_count_by_leg` shows what each leg contributed on YOUR call — read the split there, never from a figure quoted in this text."
      },
      "employment_type": {
        "type": "string",
        "enum": [
          "freelance",
          "contract",
          "permanent"
        ],
        "description": "Restrict to one engagement type. THE RADAR IS MOSTLY PERMANENT, so a freelance or contract question answered off an unfiltered page is answered with salaried jobs. For the actual split, make the filtered call and read `_meta.tranche_total_row_count` — it is counted at query time. The promoted leg declared NO contract_type until 2026-08-28 and now declares one on most of its rows, so a value here no longer drops that leg wholesale — only the rows still silent. THOSE ROWS ARE NOT A FOURTH TYPE AND NOT PERMANENT ONES: `_meta.available_employment_types` counts only what declares, and `_meta.employment_type_undeclared` carries the rest, so the two together are the rows THIS call read (`_meta.employment_mix_rows_read` — a window, NOT the tranche: `_meta.tranche_total_row_count` is the population) and either alone is not even that. Read both before quoting a mix, and quote the window with it."
      },
      "remote_mode": {
        "type": "string",
        "description": "Restrict to one work-location policy: `remote`, `hybrid` or `onsite`. READ THIS BEFORE ANSWERING A REMOTE QUESTION: a large share of the radar declares no policy at all (`_meta.remote_mode_undeclared` carries the live count — roughly half the radar when last measured, and a frozen pair written here drifted ~30% in two days), and an undeclared row is NOT an on-site row — it is a posting that does not say. Any value here therefore sets those rows aside rather than classifying them, exactly as the site's own filter does, and `_meta.remote_mode_undeclared` reports how many were set aside. The promoted leg carries its own `remote_mode` column and is filtered by the same predicate. Read `_meta.available_remote_modes` for the live spread before assuming a value exists."
      },
      "eligibility": {
        "type": "string",
        "enum": [
          "open",
          "restricted",
          "unstated"
        ],
        "description": "WHO MAY APPLY to a remote posting, read from the posting's own text: `open` (it explicitly opens the role across borders — worldwide, anywhere, a time-zone band such as EMEA/CET hours, nearshore welcome), `restricted` (it requires residence, citizenship, work authorisation, a clearance or US W-2 status somewhere, or scopes the remote work to a region — `eligibility_region` on the row names it when stated), `unstated` (it says nothing). Combine with remote_mode=\"remote\" for the contractor abroad. AN UNSTATED ROW IS NOT AN OPEN ROW: most remote postings say nothing about where the contractor may be, so `open` sets them aside and `_meta.eligibility_undeclared` counts how many remote rows THIS call read are silent. Classified deterministically from title, location and (promoted leg) description; the site-radar leg publishes no description, so its rows are mostly `unstated`."
      },
      "lang": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "description": "Reading language for the TITLE — 'EN' (default), 'FR' or 'DE'. This is a RENDERING choice, never a filter: it changes which string `title` carries, never which rows come back. Read `title_lang` on every row for the language actually served: it differs from what you asked for exactly when that translation does not exist (the live FR/DE coverage is counted on every response in `_meta.untranslated_leg`), and the verbatim is served instead, labelled with the language the harvest chain measured. `source_lang` always carries the language the ADVERTISER wrote in, translated or not. The promoted leg has no translated columns at all: its rows ignore this argument and say so with `title_lang: null` — see `_meta.untranslated_leg`."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response's `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "title_lang": {
              "type": [
                "string",
                "null"
              ],
              "description": "ISO-639-1 language the SERVED `title` is written in. READ IT ON EVERY ROW: it is what you asked for in `lang` when that translation exists, and the advertiser's own language when it does not (the live FR/DE coverage is counted on every response in `_meta.untranslated_leg`). Null when the harvest chain could not decide — on some site-radar rows too, counted in `_meta.untranslated_radar_rows` — and on every promoted-leg row, which carries no translated column at all. ⚠️ THIS FIELD CHANGED REFERENT ON 2026-09-04: until then it named the language the ADVERTISER wrote in — that fact now lives in `source_lang`. The two coincided while no translation was served and diverge from the first one that is."
            },
            "source_lang": {
              "type": [
                "string",
                "null"
              ],
              "description": "ISO-639-1 language the ADVERTISER wrote the title in, measured by the harvest chain and never changed by `lang` — 'en' on 1,566 rows, 'de' on 337 (2026-08-23). Null when the chain could not decide, and on the promoted leg. Compare it with `title_lang` to know whether the title you are quoting is the advertiser's own words or this platform's rendering of them: a harvested posting is a third party's text, and saying which of the two you are citing is the only honest way to quote it."
            },
            "firm_name": {
              "type": [
                "string",
                "null"
              ]
            },
            "location": {
              "type": [
                "string",
                "null"
              ]
            },
            "country_code": {
              "type": [
                "string",
                "null"
              ],
              "description": "ISO-3166-1 alpha-2 of the posting's own country. Null on almost all of the promoted leg."
            },
            "seniority": {
              "type": [
                "string",
                "null"
              ]
            },
            "remote_mode": {
              "type": [
                "string",
                "null"
              ],
              "description": "The posting's declared work-location policy (`remote` / `hybrid` / `onsite`). NULL means the posting does not say — never read it as on-site."
            },
            "eligibility": {
              "type": [
                "string",
                "null"
              ],
              "description": "Who may apply, read from the posting's own text: `open`, `restricted` or `unstated`. `unstated` means the text does not say — never read it as open."
            },
            "eligibility_region": {
              "type": [
                "string",
                "null"
              ],
              "description": "The ISO-3166-1 alpha-2 country, or EU / EMEA, the text names for that opening or restriction. Null when it names none."
            },
            "posted_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "source_url": {
              "type": [
                "string",
                "null"
              ]
            },
            "employment_type": {
              "type": [
                "string",
                "null"
              ]
            },
            "expires_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "rate_band": {
              "type": [
                "object",
                "null"
              ],
              "description": "Editorial benchmark for this posting's (seniority × product × region) cell — NOT a rate the employer offered. `basis` and `kind` are inside the object on purpose, so no extraction can lift the numbers away from what they mean. 2026-08-29: this band is a SUBSCRIBER surface and is no longer carried by the public radar file this lane reads — expect it to be null here. The posting's OWN published rate, when it has one, stays in currency / daily_rate_min / daily_rate_max."
            },
            "id": {
              "type": [
                "string",
                "null"
              ],
              "description": "The posting's identity — stable across calls, key for dedup."
            },
            "leg": {
              "type": [
                "string",
                "null"
              ],
              "description": "`promoted` or `site_radar` — which of the two merged public legs served this row."
            },
            "canonical_id": {
              "type": [
                "string",
                "null"
              ],
              "description": "Set when the site folded this posting into another one it judged identical: `citation_url` is then the page of THAT posting (`canonical_id`). When both are matched, only the canonical row is served and `_meta.duplicates_folded` counts the fold. Null otherwise."
            },
            "application_link": {
              "type": [
                "string",
                "null"
              ],
              "description": "`public` (source_url is served) or `members_only` (the link to the original listing is the paid Consultant-tier deliverable; the row and its facts stay public)."
            },
            "skills": {
              "type": [
                "array",
                "null"
              ],
              "description": "Skills the posting names. Null when it names none."
            },
            "category": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Posting text, HTML stripped, clamped. Null on the radar leg."
            },
            "currency": {
              "type": [
                "string",
                "null"
              ]
            },
            "daily_rate_min": {
              "type": [
                "number",
                "null"
              ],
              "description": "Only when the source declares a DAILY rate period — never converted from other periods."
            },
            "daily_rate_max": {
              "type": [
                "number",
                "null"
              ]
            },
            "rate_period": {
              "type": [
                "string",
                "null"
              ]
            },
            "duration_months": {
              "type": [
                "number",
                "null"
              ]
            },
            "salary_min": {
              "type": [
                "number",
                "null"
              ],
              "description": "The posting's own advertised salary, YEARLY (see `salary_period`). Null when none was published, and null when the published amount cannot be a yearly salary — `salary_withheld_reason` then says why."
            },
            "salary_max": {
              "type": [
                "number",
                "null"
              ]
            },
            "salary_period": {
              "type": [
                "string",
                "null"
              ],
              "description": "`year` when salary_min/salary_max are served. Null otherwise — never a guessed unit."
            },
            "salary_withheld_reason": {
              "type": [
                "string",
                "null"
              ],
              "description": "Why a published salary was NOT served: `below_annual_floor` (the low end is below any yearly salary in that currency — a monthly or daily figure filed as a salary) or `board_estimate` (the job board's own min = max estimate, not the employer's). The amount is withheld, never converted. Null when nothing was withheld."
            },
            "source": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "search_news",
  "description": "Search the Analytics Legends market-news corpus. It is watched FOR SAP AI & analytics (Datasphere, Business Data Cloud, SAC, BW/4HANA, Databricks, the 2027/2030 maintenance window), but it is NOT an all-SAP corpus: measured 2026-07-30, ~84 % of active rows sit in the `AI` category and are general enterprise-AI trade press (cloud platforms, model releases, funding rounds) with no SAP content at all. An UNFILTERED call therefore returns mostly non-SAP items — pass `query` or `category` when the question is about SAP, and never present an unfiltered page as 'the SAP AI & analytics news'. Say what you actually got. Each item returns the Analytics Legends citation URL AND the upstream publisher's source_url — cite both, and prefer source_url when you need a page that certainly carries the item. NO ITEM HERE HAS A PAGE OF ITS OWN on analyticslegends.ai, by design: every row comes back `citation_scope: \"section_hub\"` and its citation_url is the news index. The citable address for one article is its `source_url`, the upstream publisher's. Do not present the hub as the article's page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Free-text filter, case-insensitive. EVERY word must appear in the record (substring per word, any order), so a natural-language phrase narrows the answer instead of having to match verbatim."
      },
      "category": {
        "type": "string",
        "description": "Category code, matched case-insensitively. The live vocabulary is NOT written here — read `_meta.available_categories` on any response: every category label this corpus holds right now, with its active-row count, counted at query time. A written list held 21 values while the corpus held 22. One bucket needs a warning. 'SAC' is the noisiest label in this corpus because the acronym collides with unrelated ones — Windows 'Smart App Control', and the surname 'Sacks'. A 2026-07-30 cleanup reclassified half that bucket to AI for carrying no SAP signal at all; the collision pressure is structural and the bucket has kept growing since. For genuine SAC product news, pair category:'SAC' with query:'analytics cloud'."
      },
      "published_since": {
        "type": "string",
        "description": "Lower bound on `published_at`, inclusive, as YYYY-MM-DD. Without a bound a period question is only answerable by walking pages — and `_meta.match_count` then counts the QUERY, not the period, so any figure quoted for the window would be wrong."
      },
      "published_until": {
        "type": "string",
        "description": "Upper bound on `published_at`, INCLUSIVE of the day named, as YYYY-MM-DD. Combine with `published_since` for a window; `_meta.match_count` then describes that window, which is what makes it quotable."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response's `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "published_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "source_name": {
              "type": [
                "string",
                "null"
              ]
            },
            "source_url": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "search_concepts",
  "description": "Search the SAP AI & analytics concept encyclopaedia — the vocabulary of the stack, written for practitioners. Returns slug, title, category, level, tags and the editor's summary. `level` is GRADED on every active row since 2026-09-18 (the CHECK constraint accepted only the legacy vocabulary OR NULL, so the loader wrote NULL rather than fail; 108 of 330 were blank). A null, if one ever returns, means 'not graded', never 'Beginner'. These are the same fields `get_concept` returns for ONE slug. The card BODY (cheat sheet, glossary, pro tip and the four analysis tables) is Consultant-tier: call `get_concept_card`. Why-it-matters and key points are NOT served by this endpoint either, but they are published in full on the concept page at citation_url — follow the URL for those, a plan buys the body, not them.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Free-text filter, case-insensitive. EVERY word must appear in the record (substring per word, any order), so a natural-language phrase narrows the answer instead of having to match verbatim."
      },
      "category": {
        "type": "string",
        "description": "Concept category, matched case-insensitively as an exact value OR a prefix — so category:\"datasphere\" reaches 'Datasphere Core'. The values are long human labels, not codes. DO NOT GUESS THEM FROM THIS TEXT: the live vocabulary with a row count per label comes back as `_meta.available_categories` on EVERY call, including a call that matched nothing. A list written here would say 14 labels with 2026-07-30 counts; the corpus holds 15 today, and five of those counts have moved. Read the envelope, not the prose."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response's `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "get_concept",
  "description": "Fetch one concept entry by slug: title, category, level, tags and the editor's summary. Written by a named human editor, not generated. `level` is GRADED on every active row since 2026-09-18 (the CHECK constraint accepted only the legacy vocabulary OR NULL, so the loader wrote NULL rather than fail; 108 of 330 were blank). A null, if one ever returns, means 'not graded', never 'Beginner'. The card body, cheat sheet, glossary, pro tip and the four analysis tables are subscriber content and are NOT returned. Why-it-matters and key points are not returned here either, but they ARE published in full on the concept page at citation_url — follow the URL for those.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "Concept slug from search_concepts."
      }
    },
    "required": [
      "slug"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "list_studies",
  "description": "List the Analytics Legends deep-research studies with their edition, as-of date, audience, word count and canonical URL. METADATA ONLY: study bodies are a paid Consultant-tier deliverable, served by `get_study` on this same endpoint with a subscriber key. Use this to tell a reader that a study exists and where to read it. ONE ROW IS ONE LANGUAGE EDITION, NOT ONE STUDY: each study is published in every language it has been translated into, so `_meta.tranche_total_row_count` counts editions and `_meta.distinct_studies` counts the works. `_meta.available_languages` gives the live per-language counts; each row carries its `editions` list. Pass `lang` to get one row per study.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Free-text filter, case-insensitive. EVERY word must appear in the record (substring per word, any order), so a natural-language phrase narrows the answer instead of having to match verbatim."
      },
      "lang": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "description": "ISO-639-1 language of the EDITION to list, e.g. en, fr or de — each study is published as one row per language. Omit it to see every edition of every study; the live list of languages actually present comes back as `_meta.available_languages` on every response. A well-formed code the corpus does not hold returns 0 rows."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response's `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "lang": {
              "type": [
                "string",
                "null"
              ]
            },
            "editions": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "as_of": {
              "type": [
                "string",
                "null"
              ]
            },
            "word_count": {
              "type": [
                "integer",
                "null"
              ]
            },
            "access": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "get_day_rate_benchmark",
  "description": "The PUBLIC day-rate aggregate for SAP AI & analytics freelance work: min/max daily rate by country, specialisation and seniority — `daily_rate_min` / `daily_rate_max` (plus `daily_rate_median`, `daily_rate_p10`, `daily_rate_p90` when the source publishes them), every amount in the row's own `currency` — with source, source date, confidence and the sample the source states. This is the free aggregate published at analyticslegends.ai/api/market-rates.json, and it is SMALL — a few dozen rows at most, every one of them a secondary source (a published market study or a job-board scan), and `sample_size` is null on most of them. NO COUNT IS WRITTEN HERE ON PURPOSE: `_meta.tranche_total_row_count` and the rows themselves are the live measure. A frozen pair stood here until 2026-08-27 — '11 rows on 2026-08-09 … sample_size null on 8 of them' — and the second half was WRONG (7 of 11) while the first was still right, which is the whole argument against writing either. NOTHING IS HELD BACK BEHIND IT: there is no paid counterpart to this aggregate. The community-contribution path exists (public.rate_contributions) but publishes nothing yet — v_community_rate_aggregates and v_rate_index are still empty, because a contributed rate only surfaces once a cell holds enough submissions to be reported without identifying anyone. So whatever percentile a source row happens to carry is served here, free, to everyone. The GB row carries a median, p10 and p90, and its own note says its min/max ARE the 25th and 75th percentiles. What is missing from this answer is missing from THIS aggregate; it is not a paid tier. THIS IS NOT THE ONLY RATE THE PLATFORM PUBLISHES, AND ON THE QUESTIONS THIS MARKET ASKS MOST IT IS THE THINNER ONE. The website carries a `rate_band` per live radar posting for signed-in subscribers — a panel-inferred P25–P75 band per (seniority × product × region) cell, Eursap n=312 plus the Analytics Legends operator panel. This server does not serve it (`find_opportunities.rate_band` is null on every row, with or without a key). The grid covers EUROPEAN cells only — DACH, FR/Benelux, UK/IE, Southern EU, Eastern EU, Nordics — and there it prices exactly the cells this small aggregate cannot (Senior Datasphere DACH, Senior BDC DACH), where `specialisation:\"bdc\"` here returns nothing. When this tool comes back empty for a country × product: in one of those European regions, say the AGGREGATE holds no row and that subscribers read the platform's band on the posting pages; ANYWHERE ELSE (Americas, APAC, Africa, Middle East) say the platform publishes no rate for that cell at any tier — never that subscribers get one. The two are different instruments: this one is a published market study, that one is an editorial benchmark attached to a live posting. Read `_meta.available_countries` / `available_specialisations` / `available_seniorities` — they are computed from the aggregate on every call — before concluding that a rate is unpublished, and quote each row with its own currency, its confidence and its source date.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "country": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "description": "ISO-3166-1 alpha-2 country code, e.g. DE, FR, CH."
      },
      "specialisation": {
        "type": "string",
        "description": "A specialisation code, matched exactly. The live list is `_meta.available_specialisations` on every call — no list is kept here, because a written one went stale. Codes are NOT evenly spread across countries: read the rows a country filter returns. A code this aggregate does not hold (bdc, joule) returns 0 rows and the available codes; it never widens to a neighbouring band. 0 rows here is an absence in THIS aggregate only — see the tool description for what the website's subscriber band covers and where no rate exists at any tier."
      },
      "seniority": {
        "type": "string",
        "description": "e.g. senior, principal."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "country": {
              "type": [
                "string",
                "null"
              ]
            },
            "specialisation": {
              "type": [
                "string",
                "null"
              ]
            },
            "seniority": {
              "type": [
                "string",
                "null"
              ]
            },
            "currency": {
              "type": [
                "string",
                "null"
              ],
              "description": "ISO-4217 unit of every daily_rate_* amount on THIS row (EUR, GBP, CHF) — never an envelope constant."
            },
            "daily_rate_min": {
              "type": [
                "number",
                "null"
              ],
              "description": "Lower bound of the published band, in `currency`."
            },
            "daily_rate_max": {
              "type": [
                "number",
                "null"
              ],
              "description": "Upper bound of the published band, in `currency`."
            },
            "daily_rate_median": {
              "type": [
                "number",
                "null"
              ],
              "description": "Median when the source publishes one, in `currency`."
            },
            "daily_rate_p10": {
              "type": [
                "number",
                "null"
              ],
              "description": "10th percentile when the source publishes one, in `currency`."
            },
            "daily_rate_p90": {
              "type": [
                "number",
                "null"
              ],
              "description": "90th percentile when the source publishes one, in `currency`."
            },
            "sample_size": {
              "type": [
                "integer",
                "null"
              ],
              "description": "The sample the SOURCE states behind this row; null when it states none — never estimated."
            },
            "sample_basis": {
              "type": [
                "string",
                "null"
              ],
              "description": "What `sample_size` counts (profiles, vacancies…), when the source says."
            },
            "basis": {
              "type": [
                "string",
                "null"
              ],
              "description": "external_published_median | external_published_range | panel — see /api/market-rates.json _meta.basis_values."
            },
            "confidence": {
              "type": [
                "string",
                "null"
              ]
            },
            "source": {
              "type": [
                "string",
                "null"
              ]
            },
            "source_url": {
              "type": [
                "string",
                "null"
              ]
            },
            "source_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "yoy_change_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "trend": {
              "type": [
                "string",
                "null"
              ]
            },
            "note": {
              "type": [
                "string",
                "null"
              ]
            },
            "daily_rate_min_eur": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_eur": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_eur": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_min_gbp": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_gbp": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_gbp": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_p10_gbp": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_p10 + currency."
            },
            "daily_rate_p90_gbp": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_p90 + currency."
            },
            "daily_rate_min_chf": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_chf": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_min_aud": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_aud": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_aud": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_min_nzd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_nzd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_nzd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_min_sgd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_sgd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_sgd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_min_jpy": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_jpy": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_jpy": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_min_hkd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_hkd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_hkd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_min_inr": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_inr": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_inr": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_min_zar": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_zar": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "daily_rate_median_zar": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_median + currency."
            },
            "daily_rate_min_usd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_min + currency."
            },
            "daily_rate_max_usd": {
              "type": [
                "number",
                "null"
              ],
              "description": "DEPRECATED — read daily_rate_max + currency."
            },
            "indicative": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "true = orientation only: the source is a proxy (non-SAP BI band, generic ERP, agency monthly contract or marketing average). Never quote it as the SAP AI & analytics rate of its country."
            },
            "sap_scope": {
              "type": [
                "string",
                "null"
              ],
              "description": "what the source actually measures: sap_analytics | sap_general | erp_general | bi_non_sap"
            },
            "source_type": {
              "type": [
                "string",
                "null"
              ],
              "description": "primary_agency_guide | primary_job_ads | primary_salary_survey | aggregator | marketing"
            },
            "client_market": {
              "type": [
                "string",
                "null"
              ],
              "description": "india_domestic (INR, Indian client) | eu_uk_remote (EUR, India-based contractor billed to an EU/UK client). Set on the India rows only."
            },
            "source_period": {
              "type": [
                "string",
                "null"
              ]
            },
            "conversion": {
              "type": [
                "string",
                "null"
              ],
              "description": "how an hourly or monthly source figure was turned into a day rate"
            },
            "accessed": {
              "type": [
                "string",
                "null"
              ],
              "description": "date the source was read (YYYY-MM-DD)"
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "list_sap_modules",
  "description": "The canonical SAP module/product taxonomy Analytics Legends classifies against (codes and EN/FR labels by category). Use it to normalise a user's loose product wording — 'SAC', 'Analytics Cloud', 'Datasphere' — onto the codes the other tools filter on.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Free-text filter, case-insensitive. EVERY word must appear in the record (substring per word, any order), so a natural-language phrase narrows the answer instead of having to match verbatim."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response's `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "code": {
              "type": [
                "string",
                "null"
              ]
            },
            "label_en": {
              "type": [
                "string",
                "null"
              ]
            },
            "category": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "find_academy_modules",
  "description": "Search the Analytics Legends Academy — the written training modules on SAP Datasphere, Business Data Cloud, SAP Analytics Cloud, BW/4HANA and Databricks — by track, level and free text. `_meta.tranche_total_row_count` carries the live catalogue size on every call; it is the only count to quote. Returns the catalogue entry: id, slug, EN/FR title, track, level, duration in minutes, tags and the editor's summary. DO NOT CONFUSE IT WITH `list_sap_modules`, which serves a different population under the same word: that one is the 40-row PRODUCT taxonomy (codes such as SAC, DATASPHERE) used to normalise product wording. This one is the course catalogue. Without `query`, rows come back in the catalogue's own CURRICULUM order — the order a reader is meant to take them in — track by track. This catalogue is written training, NOT SAP certification tracks: this server publishes no certification data at any tier, so a certification question has no answer here rather than a partial one. CATALOGUE ONLY — the module BODY is subscriber content, served by `get_academy_module` on this same endpoint with an API key of an MCP Pass or Firm account. On THIS endpoint the paid tranche is opened by the MCP Pass (€29.90/month, analyticslegends.ai/mcp-server/) or the Firm Pass, from one key; the Consultant and Legend web plans do not include MCP access. `status` and `is_preview` are SERVED, never filtered on: they are the two flags the platform marks free access with, they do not coincide (measured 2026-08-16: 38 rows `status='available'`, 56 rows `is_preview`), and you decide which one your answer needs. PAGINATED WITH A KEY (a free one is enough): pass `_meta.next_cursor` back as `cursor` with the same filters until it is null; without a key, first 10 rows only. Read `_meta.available_tracks` and `_meta.available_levels` — both counted on the served population at call time — before assuming a facet value exists.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Free-text filter, case-insensitive. EVERY word must appear in the record (substring per word, any order), so a natural-language phrase narrows the answer instead of having to match verbatim."
      },
      "track": {
        "type": "string",
        "description": "Restrict to one track, by SLUG (`databricks-data-eng`) or by English name (`Databricks & Data Eng.`), matched case-insensitively. The live vocabulary with per-track counts is `_meta.available_tracks` on every response. The numeric track_id is deliberately NOT accepted — it is an internal counter, and passing `6` would look like naming a subject."
      },
      "level": {
        "type": "string",
        "description": "Restrict to one level, matched case-insensitively: Beginner · Intermediate · Advanced · Expert. Counts in `_meta.available_levels`."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response's `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": [
                "string",
                "null"
              ],
              "description": "Module id, e.g. M001 — the value get_academy_module takes."
            },
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "title_en": {
              "type": [
                "string",
                "null"
              ]
            },
            "track_slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "level": {
              "type": [
                "string",
                "null"
              ]
            },
            "duration_minutes": {
              "type": [
                "number",
                "null"
              ]
            },
            "summary_en": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "type": [
                "string",
                "null"
              ],
              "description": "Editorial access marker: 'available' or 'legend-pass'. Served, not filtered on. READ 'legend-pass' AS 'sold at the CONSULTANT tier': it is a LEGACY label from when the paid tier was called Legend, it sits on the majority of rows, and the tier that actually opens the body here is Consultant (get_academy_module). The site stopped rendering this field for exactly that reason on 2026-07-26; this endpoint still serves the raw value, so the LABEL is the stale half and the tier floor is the true one."
            },
            "is_preview": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "The second free-access marker. Does NOT coincide with status — read both."
            },
            "title_fr": {
              "type": [
                "string",
                "null"
              ]
            },
            "summary_fr": {
              "type": [
                "string",
                "null"
              ]
            },
            "track_name_en": {
              "type": [
                "string",
                "null"
              ]
            },
            "track_name_fr": {
              "type": [
                "string",
                "null"
              ]
            },
            "tags": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "updated_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "query_knowledge_graph",
  "description": "The RELATIONS between the platform's teaching objects — which Academy module teaches which concept, which study covers which module, what a concept relates to. THIS IS THE ONLY TOOL ON THIS SERVER THAT SERVES EDGES; the others serve rows. Ask it what connects to what, not what exists. SCOPE, AND IT IS NARROWER THAN 'the knowledge graph': it carries four node types — `concept`, `module`, `study`, `vendor` — and every edge whose BOTH endpoints are one of them. The whole graph holds twelve node types; the eight it does not carry are each either served by their own tool or named as not served at all, and `_meta.excluded_node_types` says which per type (consultant data is served at NO tier), so a missing type is a documented boundary and never a silent gap. Call it with `node_id` (e.g. `module:M178`, `concept:C001`, `study:ai-impact-2026-EN`) to walk one node's neighbourhood; with `node_type` and/or `query` to find a node id first. `edge_type` and `direction` narrow a walk. Read `_meta.available_edge_types` — computed from the served projection on every call — before assuming an edge type exists.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "node_id": {
        "type": "string",
        "description": "Fully-qualified node id, `<type>:<id>` — `module:M178`, `concept:C001`, `study:ai-impact-2026-EN`, `vendor:alteryx`. With it, rows are that node&#39;s EDGES (one row per neighbour). Without it, rows are NODES."
      },
      "node_type": {
        "type": "string",
        "description": "Restrict to one carried node type: concept · module · study · vendor. Read `_meta.available_node_types`."
      },
      "edge_type": {
        "type": "string",
        "description": "Restrict a walk to one relation. The authority is `_meta.available_edge_types`, computed on every call — no list is kept here: a four-name list once stood here while the projection served five, then a five-name list while it served six (`broader`)."
      },
      "direction": {
        "type": "string",
        "enum": [
          "from",
          "to",
          "both"
        ],
        "description": "Which side of the edge `node_id` must sit on. Default `both`. Ignored without `node_id`, and the response says so rather than pretending it applied."
      },
      "query": {
        "type": "string",
        "description": "Case-insensitive substring of a node&#39;s label. Applies to the NODE listing, not to a walk. Matched against the label SERVED, so it follows `lang`."
      },
      "lang": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "description": "ISO-639-1 language for the LABELS — en, fr or de. Defaults to en. The fallback is declared and never silent: the language asked for, then English, then French, and `_meta.label_language_coverage` says on how many nodes each language is actually filled. Concept and module titles carry French; German arrives as the corpus is translated, and an untranslated node falls back rather than being hidden."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 10,
        "description": "Max rows (hard cap 50)."
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Opaque token from a previous response&#39;s `_meta.next_cursor`. Pass it back with the SAME filter arguments; `null` means the last page. Changing a filter refuses the cursor."
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "node_id": {
              "type": [
                "string",
                "null"
              ]
            },
            "node_type": {
              "type": [
                "string",
                "null"
              ]
            },
            "label": {
              "type": [
                "string",
                "null"
              ],
              "description": "In the language asked for when the node carries it, else the declared fallback — see `label_lang`."
            },
            "label_lang": {
              "type": [
                "string",
                "null"
              ],
              "description": "The language the served `label` is actually written in. It differs from the requested `lang` exactly when that translation does not exist."
            },
            "edge_type": {
              "type": [
                "string",
                "null"
              ],
              "description": "Present only on a walk (when `node_id` was given)."
            },
            "direction": {
              "type": [
                "string",
                "null"
              ],
              "description": "`out` = node_id → neighbour, `in` = neighbour → node_id, `both` = the relation is stored in both directions (served once — see `_meta.symmetric_edges_folded`). Walk rows only."
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "get_concept_card",
  "description": "The FULL encyclopaedia card for one concept — body, cheat sheet, glossary, pro tip, and the four analysis tables (decision table, peer comparison, named pitfalls, performance facts), EN, FR and DE, plus why-it-matters and key points (those two are also published free on the concept page; here they come structured, in three languages, in the same payload) — the corpus the Consultant web plan sells. On THIS endpoint the paid tranche is opened by the MCP Pass (€29.90/month, analyticslegends.ai/mcp-server/) or the Firm Pass, from one key; the Consultant and Legend web plans do not include MCP access. Requires the API key of an MCP Pass or Firm account (Authorization: Bearer alk_…) — the Consultant and Legend web plans do not include MCP access; without one this tool refuses and get_concept keeps serving the public metadata. Find slugs with search_concepts.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "Concept slug, verbatim from search_concepts.rows[].slug."
      }
    },
    "required": [
      "slug"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "title_en": {
              "type": [
                "string",
                "null"
              ]
            },
            "body_en": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}

{
  "name": "get_study",
  "description": "Read one Analytics Legends study BODY — the paid text behind list_studies' metadata. Requires the API key of an MCP Pass or Firm account (the Consultant and Legend web plans do not include MCP access). Bodies run to 38k words and exceed the 256 KiB response ceiling, so this tool serves STRUCTURE first: called without `section` it returns the section list and the introduction; pass `section` (a heading from that list, matched case-insensitively) to read one section. Find slugs and languages with list_studies.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "Study slug, verbatim from list_studies.rows[].slug."
      },
      "lang": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$",
        "default": "en",
        "description": "ISO-639-1 language of the edition, e.g. en or fr. Defaults to en."
      },
      "section": {
        "type": "string",
        "maxLength": 200,
        "description": "A section heading from a previous call's `sections` list. Omit to get the list."
      }
    },
    "required": [
      "slug"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "result_count": {
        "type": "integer"
      },
      "rows": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "slug": {
              "type": [
                "string",
                "null"
              ]
            },
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "section_heading": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation_url": {
              "type": "string"
            },
            "citation_scope": {
              "type": "string",
              "enum": [
                "record",
                "section_hub"
              ]
            }
          }
        }
      },
      "_meta": {
        "type": "object"
      },
      "_attribution": {
        "type": "string"
      }
    },
    "required": [
      "tool",
      "result_count",
      "rows",
      "_attribution"
    ]
  }
}