RAK MCP — tool catalog

Auto-generated from the source of truth (zero drift). Every `rak_<module>_<op>` tool, with full JSON Schema for inputs. Anon tier reads work without a key.

Raw JSON: /api/mcp/rak/tools · Filter: ?module=content · Spec: /spec · Repo: GitHub

content

rak_content_searchanon · freescope: content:read · billing: none

Hybrydowe wyszukiwanie (FTS + semantyka, RRF) po opublikowanych treściach RAK. Zwraca najtrafniejsze artykuły z oceną podobieństwa.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 400,
      "description": "Zapytanie po polsku (lub w dowolnym języku)."
    },
    "section": {
      "type": "string",
      "maxLength": 64,
      "description": "Opcjonalny filtr sekcji (section_id)."
    },
    "alpha": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Waga dense vs sparse (0..1, domyślnie zbalansowana)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Liczba wyników (domyślnie 8)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_content_get_articleanon · freescope: content:read · billing: none

Pobierz pełną treść opublikowanego artykułu po `slug` lub `id`.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 256,
      "description": "Slug artykułu."
    },
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID artykułu."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_content_list_sectionanon · freescope: content:read · billing: none

Lista najnowszych opublikowanych artykułów w danej sekcji (paginacja).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "section_id (np. 'technologia', 'swiat')."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Domyślnie 20."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Domyślnie 0."
    }
  },
  "required": [
    "section"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_content_wire_feedanon · freescope: content:read · billing: none

Syndykowany feed wire (depesze) RAK — świeże, ocenione redakcyjnie pozycje.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "maxLength": 64,
      "description": "Opcjonalny filtr sekcji."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Domyślnie 25."
    },
    "since": {
      "type": "string",
      "maxLength": 40,
      "description": "ISO data — tylko nowsze niż."
    },
    "minScore": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Minimalny editorial score."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_content_region_feedanon · freescope: content:read · billing: none

Artykuły z danego regionu (węzeł PL = województwo, po slug lokalnej witryny, np. 'mazowieckie'). Param `region` (alias wsteczny: `voivodeship`). Lista dostępnych: rak_meta_list_sources / zasób rak://voivodeships.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "minLength": 2,
      "maxLength": 48,
      "description": "Slug regionu (PL: województwo, np. 'mazowieckie')."
    },
    "voivodeship": {
      "type": "string",
      "minLength": 2,
      "maxLength": 48,
      "description": "Alias `region` (deprecated)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Domyślnie 20."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crawl

rak_crawl_searchinternal onlyscope: skills:action · billing: self

Przeszukaj świeżą pulę zaciągniętych artykułów (globalną + własne źródła).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 500
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "languages": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 2
      }
    },
    "sinceHours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 720
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "includeUserSources": {
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_crawl_add_sourceinternal onlyscope: skills:action · billing: self

Dodaj własne źródło crawla (RSS/Google News/HTML/Firecrawl). SSRF-validated.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "rss",
        "googlenews",
        "html",
        "firecrawl"
      ],
      "default": "rss"
    },
    "language": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "default": "pl"
    },
    "targetSectionId": {
      "type": "string"
    },
    "crawlFrequencyMinutes": {
      "type": "integer",
      "minimum": 15,
      "maximum": 1440,
      "default": 120
    },
    "maxArticlesPerCrawl": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  },
  "required": [
    "name",
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_crawl_subscribeinternal onlyscope: skills:action · billing: self

Subskrybuj temat dla bota (godzinowo/dziennie).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 300
    },
    "botId": {
      "type": "string",
      "format": "uuid"
    },
    "frequency": {
      "type": "string",
      "enum": [
        "hourly",
        "daily"
      ],
      "default": "daily"
    },
    "maxPerRun": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 5
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

distribution

rak_distribution_publishinternal onlyscope: skills:action · billing: none

Syndykuj opublikowany artykuł do innych portali Murd0ch Empire (internal).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "articleId": {
      "type": "string",
      "format": "uuid",
      "description": "ID opublikowanego artykułu źródłowego."
    },
    "sourcePortalId": {
      "type": "string",
      "minLength": 1,
      "description": "Portal źródłowy."
    },
    "targets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "portalId": {
            "type": "string",
            "minLength": 1
          },
          "tenantId": {
            "type": "string",
            "minLength": 1
          },
          "targetSection": {
            "type": "string",
            "minLength": 1
          },
          "autoPublish": {
            "type": "boolean",
            "default": false
          }
        },
        "required": [
          "portalId",
          "tenantId",
          "targetSection"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "description": "Lista portali docelowych."
    }
  },
  "required": [
    "articleId",
    "sourcePortalId",
    "targets"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

media

rak_media_generate_imagepaidscope: skills:action · billing: self

Wygeneruj obraz z promptu (async — zwraca jobId; odpytuj rak_meta_health/jobs lub pollUrl).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 5,
      "maxLength": 400,
      "description": "Opis obrazu."
    },
    "artifactId": {
      "type": "string",
      "format": "uuid",
      "description": "Powiąż z artefaktem."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_media_generate_videopaidscope: skills:action · billing: self

Wygeneruj wideo (async). Modele: kling (5/10s), veo3 (8s), runway (5/10s). Zwraca jobId.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 5,
      "maxLength": 500
    },
    "model": {
      "type": "string",
      "enum": [
        "kling",
        "veo3",
        "runway"
      ]
    },
    "duration": {
      "type": "number",
      "enum": [
        5,
        8,
        10
      ]
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ]
    },
    "imageUrl": {
      "type": "string",
      "format": "uri",
      "description": "Obraz startowy (image-to-video)."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_media_ttspaidscope: skills:action · billing: self

Synteza mowy (ElevenLabs, fallback OpenAI TTS). Długie teksty są dzielone i sklejane.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    },
    "voice": {
      "type": "string",
      "enum": [
        "newscaster",
        "conversational",
        "documentary"
      ]
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

owned

rak_owned_publishpaidscope: skills:action · billing: none

Opublikuj swój artefakt jako WŁASNĄ treść (content object) z licencją. Trafia do Twojego pasma twórcy (creator:<id>), nie do wire/portalu. Domyślnie owned_public = cytowalna przez agentów AI. Zwraca slug + licencję + namespace.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "artifactId": {
      "type": "string",
      "minLength": 8,
      "description": "ID artefaktu (np. z rak_write_draft)."
    },
    "license": {
      "type": "string",
      "enum": [
        "owned_public",
        "owned_licensed",
        "restricted"
      ],
      "description": "Licencja treści (domyślnie owned_public — publiczna, cytowalna)."
    },
    "section": {
      "type": "string",
      "maxLength": 64,
      "description": "Opcjonalny section_id."
    }
  },
  "required": [
    "artifactId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_owned_listpaidscope: content:read · billing: none

Wylistuj swoje treści (content objects) z Twojego pasma twórcy.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Liczba wyników (domyślnie 20)."
    },
    "status": {
      "type": "string",
      "enum": [
        "published",
        "draft",
        "scheduled",
        "all"
      ],
      "description": "Filtr statusu (domyślnie published)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_owned_getpaidscope: content:read · billing: none

Pobierz jedną swoją treść po slug (pełny content + licencja).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 2,
      "maxLength": 255,
      "description": "Slug treści z Twojego pasma."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_owned_verifypaidscope: content:read · billing: none

Zweryfikuj provenance swojej treści on-demand (po `slug` lub `id`): czy sygnatura ważna i czy treść nienaruszona (tamper-evidence). Zwraca verified + powód.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 255,
      "description": "Slug treści z Twojego pasma."
    },
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID artykułu z Twojego pasma."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

qa

rak_qa_fact_checkpaidscope: skills:action · billing: central

Weryfikacja faktów w tekście (Perplexity) — twierdzenia, status, źródła, ocena 0–100, korekta.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 50,
      "maxLength": 60000,
      "description": "Tekst artykułu do weryfikacji."
    },
    "section": {
      "type": "string",
      "maxLength": 64,
      "description": "Sekcja kontekstowa."
    },
    "researchBrief": {
      "type": "string",
      "maxLength": 10000
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_qa_moderatepaidscope: skills:action · billing: none

Moderacja treści — długość, struktura, wulgaryzmy, powtórzenia. Zwraca passed + listę uwag.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80000
    },
    "title": {
      "type": "string",
      "maxLength": 300
    }
  },
  "required": [
    "content"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_qa_uniquenesspaidscope: skills:action · billing: none

Sprawdzenie oryginalności względem archiwum RAK — score 0–100, ryzyko duplikatu, dopasowania.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "content": {
      "type": "string",
      "minLength": 50,
      "maxLength": 80000
    }
  },
  "required": [
    "title",
    "content"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rag

rak_rag_find_relatedanon · freescope: content:read · billing: none

Znajdź artykuły powiązane z zapytaniem lub z konkretnym artykułem (po `slug`).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 400,
      "description": "Tekst zapytania."
    },
    "slug": {
      "type": "string",
      "maxLength": 256,
      "description": "Slug artykułu — szukaj podobnych do niego."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Domyślnie 6."
    },
    "section": {
      "type": "string",
      "maxLength": 64
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_rag_semantic_searchanon · freescope: content:read · billing: none

Gęste (dense) wyszukiwanie wektorowe po embeddingach artykułów RAK.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 400,
      "description": "Zapytanie."
    },
    "matchCount": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Domyślnie 10."
    },
    "section": {
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

research

rak_research_webanon · freescope: content:read · billing: central

Web research z cytowaniami (Perplexity Sonar). Anon: 5/dzień/IP. Zwraca fakty, kontekst i źródła.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 3,
      "maxLength": 400,
      "description": "Temat / pytanie do zbadania."
    },
    "section": {
      "type": "string",
      "maxLength": 64,
      "description": "Sekcja kontekstowa (np. 'swiat', 'technologia')."
    },
    "instructions": {
      "type": "string",
      "maxLength": 2000,
      "description": "Dodatkowe wskazówki dla researchu."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_research_extractanon · freescope: content:read · billing: central

Pobierz dowolny URL i zwróć czysty markdown (SSRF-safe). Firecrawl → Sonar → Playwright fallback.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2000,
      "description": "Adres URL do ekstrakcji."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_research_fact_packpaidscope: skills:action · billing: self

Sklej twarde fakty + źródła + ryzyka z materiału researchowego (web i/lub archiwum portalu).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 3,
      "maxLength": 400
    },
    "web_research": {
      "type": "string",
      "maxLength": 50000
    },
    "portal_rag": {
      "type": "string",
      "maxLength": 20000
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_research_summarizepaidscope: skills:action · billing: self

Streszczenie tematu z archiwum RAK (hybrydowy retrieval + synteza) z listą źródeł.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300
    },
    "section": {
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write

rak_write_draftpaidscope: skills:action · billing: self

Stwórz szkic artykułu jako artefakt (zwraca artifactId).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 3,
      "maxLength": 180
    },
    "topic": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300
    },
    "type": {
      "type": "string",
      "maxLength": 40
    },
    "content": {
      "type": "string",
      "minLength": 200,
      "maxLength": 50000
    }
  },
  "required": [
    "title",
    "topic",
    "content"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_write_editpaidscope: skills:action · billing: self

Edytuj istniejący szkic (nowa wersja artefaktu).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "artifactId": {
      "type": "string",
      "format": "uuid"
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 50000
    },
    "title": {
      "type": "string",
      "maxLength": 180
    }
  },
  "required": [
    "artifactId",
    "content"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_write_exportpaidscope: skills:action · billing: self

Wyeksportuj artefakt do markdown/html/fountain lub do formatu publikacji.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "artifactId": {
      "type": "string",
      "format": "uuid"
    },
    "format": {
      "type": "string",
      "enum": [
        "markdown",
        "html",
        "publish",
        "fountain"
      ]
    }
  },
  "required": [
    "artifactId",
    "format"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_write_planpaidscope: skills:action · billing: self

Zaproponuj plan redakcyjny (blueprint) — wejście do pełnego pipeline'u.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 3,
      "maxLength": 180
    },
    "content": {
      "type": "string",
      "minLength": 80,
      "maxLength": 50000
    },
    "topic": {
      "type": "string",
      "maxLength": 300
    },
    "articleType": {
      "type": "string",
      "maxLength": 40
    },
    "pipelineDepth": {
      "type": "string",
      "enum": [
        "minimal",
        "standard",
        "full",
        "intelligence"
      ]
    }
  },
  "required": [
    "content"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_write_pipelinepaidscope: skills:action · billing: self

Uruchom pełny pipeline (research→write→fact-check) z blueprintu. Asynchroniczny — zwraca runId + pollUrl.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "blueprintArtifactId": {
      "type": "string",
      "format": "uuid"
    },
    "topicOverride": {
      "type": "string",
      "maxLength": 300
    },
    "botId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "blueprintArtifactId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rak_write_publishinternal onlyscope: skills:action · billing: self

Opublikuj/zaplanuj artefakt do sekcji portalu (internal).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "artifactId": {
      "type": "string",
      "format": "uuid"
    },
    "sectionId": {
      "type": "string",
      "maxLength": 64
    },
    "scheduledAt": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "artifactId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

35 tools · 10 modules · catalog rebuilt on each request from `ALL_RAK_TOOLS` + `TOOL_POLICY`.