ris_dokument

Retrieve complete legal document text from Austria's official legal database. Use after searching to load full laws or decisions, with options for markdown or JSON output.

Instructions

Retrieve full text of a legal document.

Use this after searching to load the complete text of a specific law or decision.

Note: For long documents, content may be truncated. Use specific searches to narrow down.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`dokumentnummer`	No	RIS document number (e.g., "NOR40052761") - from search results
`url`	No	Direct URL to document content
`response_format`	No	"markdown" (default) or "json"	markdown

Implementation Reference

src/tools/dokument.ts:40-268 (handler)

The handler function for `ris_dokument` tool, which handles document retrieval by number or URL, including fallback to search APIs and content fetching.

async (args) => {
  const { dokumentnummer, url: inputUrl, response_format } = args;

  if (!dokumentnummer && !inputUrl) {
    return createMcpResponse(
      '**Fehler:** Bitte gib entweder eine `dokumentnummer` oder eine `url` an.\n\n' +
        'Die Dokumentnummer findest du in den Suchergebnissen von `ris_bundesrecht`, ' +
        '`ris_landesrecht` oder `ris_judikatur`.',
    );
  }

  // SSRF protection: validate user-supplied URLs against domain allowlist
  if (inputUrl && !isAllowedUrl(inputUrl)) {
    return createMcpResponse(
      '**Fehler:** Die angegebene URL ist nicht erlaubt.\n\n' +
        'Nur HTTPS-URLs zu offiziellen RIS-Domains sind zulaessig ' +
        '(data.bka.gv.at, www.ris.bka.gv.at, ris.bka.gv.at).',
    );
  }

  try {
    let contentUrl = inputUrl;
    let htmlContent: string | undefined;
    let metadata: DocumentMetadata;

    if (dokumentnummer && !inputUrl) {
      // Strategy: Try direct URL construction first, fallback to search API
      const directResult = await getDocumentByNumber(dokumentnummer);

      if (directResult.success) {
        // Direct fetch succeeded - use minimal metadata
        htmlContent = directResult.html;
        contentUrl = directResult.url;
        metadata = {
          dokumentnummer,
          applikation: 'Unbekannt',
          titel: dokumentnummer,
          kurztitel: null,
          citation: {},
          dokument_url: directResult.url,
        };
      } else {
        // Direct fetch failed - fallback to search API
        let apiResponse;

        if (dokumentnummer.startsWith('NOR')) {
          apiResponse = await searchBundesrecht({
            Applikation: 'BrKons',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (
          dokumentnummer.startsWith('LBG') ||
          dokumentnummer.startsWith('LNO') ||
          dokumentnummer.startsWith('LST') ||
          dokumentnummer.startsWith('LTI') ||
          dokumentnummer.startsWith('LVO') ||
          dokumentnummer.startsWith('LWI') ||
          dokumentnummer.startsWith('LSB') ||
          dokumentnummer.startsWith('LOO') ||
          dokumentnummer.startsWith('LKT')
        ) {
          apiResponse = await searchLandesrecht({
            Applikation: 'LrKons',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('JFR') || dokumentnummer.startsWith('JFT')) {
          apiResponse = await searchJudikatur({
            Applikation: 'Vfgh',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('JWR') || dokumentnummer.startsWith('JWT')) {
          apiResponse = await searchJudikatur({
            Applikation: 'Vwgh',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('BVWG')) {
          apiResponse = await searchJudikatur({
            Applikation: 'Bvwg',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('LVWG')) {
          apiResponse = await searchJudikatur({
            Applikation: 'Lvwg',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('DSB')) {
          apiResponse = await searchJudikatur({
            Applikation: 'Dsk',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('GBK')) {
          apiResponse = await searchJudikatur({
            Applikation: 'Gbk',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('PVAK')) {
          apiResponse = await searchJudikatur({
            Applikation: 'Pvak',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('ASYLGH')) {
          apiResponse = await searchJudikatur({
            Applikation: 'AsylGH',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('BGBLA') || dokumentnummer.startsWith('BGBL')) {
          // Bundesgesetzblätter - use Bundesrecht endpoint
          const applikation = dokumentnummer.startsWith('BGBLA') ? 'BgblAuth' : 'BgblAlt';
          apiResponse = await searchBundesrecht({
            Applikation: applikation,
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('REGV')) {
          // Regierungsvorlagen - use Bundesrecht endpoint
          apiResponse = await searchBundesrecht({
            Applikation: 'RegV',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else if (dokumentnummer.startsWith('MRP') || dokumentnummer.startsWith('ERL')) {
          // Sonstige Sammlungen - use Sonstige endpoint
          apiResponse = await searchSonstige({
            Applikation: dokumentnummer.startsWith('MRP') ? 'Mrp' : 'Erlaesse',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        } else {
          // Default to Justiz for unknown prefixes
          apiResponse = await searchJudikatur({
            Applikation: 'Justiz',
            Dokumentnummer: dokumentnummer,
            DokumenteProSeite: 'Ten',
          });
        }

        // Find the document with matching dokumentnummer (don't blindly take first result)
        const findResult = findDocumentByDokumentnummer(apiResponse.documents, dokumentnummer);

        if (!findResult.success) {
          // Both direct fetch and search failed - provide helpful error
          const directError = directResult.error;
          if (findResult.error === 'no_documents') {
            return createMcpResponse(
              `**Fehler:** Kein Dokument mit der Nummer \`${dokumentnummer}\` gefunden.\n\n` +
                `Direkter Abruf: ${directError}\n` +
                `Suche: Keine Ergebnisse.\n\n` +
                'Bitte pruefe die Dokumentnummer oder verwende eine Suche, ' +
                'um das gewuenschte Dokument zu finden.',
            );
          } else {
            return createMcpResponse(
              `**Fehler:** Dokument \`${dokumentnummer}\` nicht gefunden.\n\n` +
                `Direkter Abruf: ${directError}\n` +
                `Suche: ${findResult.totalResults} Ergebnisse, aber keines mit dieser Dokumentnummer.\n\n` +
                `Bitte verwende eine alternative Suche oder die direkte URL.`,
            );
          }
        }

        const doc = findResult.document;
        contentUrl = doc.content_urls.html ?? undefined;

        if (!contentUrl) {
          return createMcpResponse(
            `**Fehler:** Keine Inhalts-URL fuer Dokument \`${dokumentnummer}\` verfuegbar.\n\n` +
              'Das Dokument hat moeglicherweise keinen abrufbaren Volltext.',
          );
        }

        // Build metadata from search result
        metadata = {
          dokumentnummer: doc.dokumentnummer,
          applikation: doc.applikation,
          titel: doc.titel,
          kurztitel: doc.kurztitel,
          citation: {
            kurztitel: doc.citation.kurztitel,
            langtitel: doc.citation.langtitel,
            kundmachungsorgan: doc.citation.kundmachungsorgan,
            paragraph: doc.citation.paragraph,
            eli: doc.citation.eli,
            inkrafttreten: doc.citation.inkrafttreten,
            ausserkrafttreten: doc.citation.ausserkrafttreten,
          },
          dokument_url: doc.dokument_url,
          gesamte_rechtsvorschrift_url: doc.gesamte_rechtsvorschrift_url,
        };
      }
    } else {
      // Only URL provided - minimal metadata
      metadata = {
        dokumentnummer: dokumentnummer ?? 'Unbekannt',
        applikation: 'Unbekannt',
        titel: inputUrl ?? '',
        kurztitel: null,
        citation: {},
        dokument_url: inputUrl,
      };
    }

    if (!contentUrl) {
      return createMcpResponse('**Fehler:** Keine gueltige URL zum Abrufen des Dokuments.');
    }

    // Fetch document content if not already fetched via direct URL
    if (!htmlContent) {
      htmlContent = await getDocumentContent(contentUrl);
    }

    // Format the document
    const formatted = formatDocument(htmlContent, metadata, response_format);
    const result = truncateResponse(formatted);

    return createMcpResponse(result);
  } catch (e) {
    return createMcpResponse(formatErrorResponse(e));
  }
},

src/tools/dokument.ts:29-39 (schema)

Schema definitions for the `ris_dokument` tool inputs.

{
  dokumentnummer: z
    .string()
    .optional()
    .describe('RIS document number (e.g., "NOR40052761") - from search results'),
  url: z.string().optional().describe('Direct URL to document content'),
  response_format: z
    .enum(['markdown', 'json'])
    .default('markdown')
    .describe('"markdown" (default) or "json"'),
},

src/tools/dokument.ts:21-270 (registration)

Registration function for the `ris_dokument` tool.

export function registerDokumentTool(server: McpServer): void {
  server.tool(
    'ris_dokument',
    `Retrieve full text of a legal document.

Use this after searching to load the complete text of a specific law or decision.

Note: For long documents, content may be truncated. Use specific searches to narrow down.`,
    {
      dokumentnummer: z
        .string()
        .optional()
        .describe('RIS document number (e.g., "NOR40052761") - from search results'),
      url: z.string().optional().describe('Direct URL to document content'),
      response_format: z
        .enum(['markdown', 'json'])
        .default('markdown')
        .describe('"markdown" (default) or "json"'),
    },
    async (args) => {
      const { dokumentnummer, url: inputUrl, response_format } = args;

      if (!dokumentnummer && !inputUrl) {
        return createMcpResponse(
          '**Fehler:** Bitte gib entweder eine `dokumentnummer` oder eine `url` an.\n\n' +
            'Die Dokumentnummer findest du in den Suchergebnissen von `ris_bundesrecht`, ' +
            '`ris_landesrecht` oder `ris_judikatur`.',
        );
      }

      // SSRF protection: validate user-supplied URLs against domain allowlist
      if (inputUrl && !isAllowedUrl(inputUrl)) {
        return createMcpResponse(
          '**Fehler:** Die angegebene URL ist nicht erlaubt.\n\n' +
            'Nur HTTPS-URLs zu offiziellen RIS-Domains sind zulaessig ' +
            '(data.bka.gv.at, www.ris.bka.gv.at, ris.bka.gv.at).',
        );
      }

      try {
        let contentUrl = inputUrl;
        let htmlContent: string | undefined;
        let metadata: DocumentMetadata;

        if (dokumentnummer && !inputUrl) {
          // Strategy: Try direct URL construction first, fallback to search API
          const directResult = await getDocumentByNumber(dokumentnummer);

          if (directResult.success) {
            // Direct fetch succeeded - use minimal metadata
            htmlContent = directResult.html;
            contentUrl = directResult.url;
            metadata = {
              dokumentnummer,
              applikation: 'Unbekannt',
              titel: dokumentnummer,
              kurztitel: null,
              citation: {},
              dokument_url: directResult.url,
            };
          } else {
            // Direct fetch failed - fallback to search API
            let apiResponse;

            if (dokumentnummer.startsWith('NOR')) {
              apiResponse = await searchBundesrecht({
                Applikation: 'BrKons',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (
              dokumentnummer.startsWith('LBG') ||
              dokumentnummer.startsWith('LNO') ||
              dokumentnummer.startsWith('LST') ||
              dokumentnummer.startsWith('LTI') ||
              dokumentnummer.startsWith('LVO') ||
              dokumentnummer.startsWith('LWI') ||
              dokumentnummer.startsWith('LSB') ||
              dokumentnummer.startsWith('LOO') ||
              dokumentnummer.startsWith('LKT')
            ) {
              apiResponse = await searchLandesrecht({
                Applikation: 'LrKons',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('JFR') || dokumentnummer.startsWith('JFT')) {
              apiResponse = await searchJudikatur({
                Applikation: 'Vfgh',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('JWR') || dokumentnummer.startsWith('JWT')) {
              apiResponse = await searchJudikatur({
                Applikation: 'Vwgh',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('BVWG')) {
              apiResponse = await searchJudikatur({
                Applikation: 'Bvwg',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('LVWG')) {
              apiResponse = await searchJudikatur({
                Applikation: 'Lvwg',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('DSB')) {
              apiResponse = await searchJudikatur({
                Applikation: 'Dsk',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('GBK')) {
              apiResponse = await searchJudikatur({
                Applikation: 'Gbk',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('PVAK')) {
              apiResponse = await searchJudikatur({
                Applikation: 'Pvak',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('ASYLGH')) {
              apiResponse = await searchJudikatur({
                Applikation: 'AsylGH',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('BGBLA') || dokumentnummer.startsWith('BGBL')) {
              // Bundesgesetzblätter - use Bundesrecht endpoint
              const applikation = dokumentnummer.startsWith('BGBLA') ? 'BgblAuth' : 'BgblAlt';
              apiResponse = await searchBundesrecht({
                Applikation: applikation,
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('REGV')) {
              // Regierungsvorlagen - use Bundesrecht endpoint
              apiResponse = await searchBundesrecht({
                Applikation: 'RegV',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else if (dokumentnummer.startsWith('MRP') || dokumentnummer.startsWith('ERL')) {
              // Sonstige Sammlungen - use Sonstige endpoint
              apiResponse = await searchSonstige({
                Applikation: dokumentnummer.startsWith('MRP') ? 'Mrp' : 'Erlaesse',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            } else {
              // Default to Justiz for unknown prefixes
              apiResponse = await searchJudikatur({
                Applikation: 'Justiz',
                Dokumentnummer: dokumentnummer,
                DokumenteProSeite: 'Ten',
              });
            }

            // Find the document with matching dokumentnummer (don't blindly take first result)
            const findResult = findDocumentByDokumentnummer(apiResponse.documents, dokumentnummer);

            if (!findResult.success) {
              // Both direct fetch and search failed - provide helpful error
              const directError = directResult.error;
              if (findResult.error === 'no_documents') {
                return createMcpResponse(
                  `**Fehler:** Kein Dokument mit der Nummer \`${dokumentnummer}\` gefunden.\n\n` +
                    `Direkter Abruf: ${directError}\n` +
                    `Suche: Keine Ergebnisse.\n\n` +
                    'Bitte pruefe die Dokumentnummer oder verwende eine Suche, ' +
                    'um das gewuenschte Dokument zu finden.',
                );
              } else {
                return createMcpResponse(
                  `**Fehler:** Dokument \`${dokumentnummer}\` nicht gefunden.\n\n` +
                    `Direkter Abruf: ${directError}\n` +
                    `Suche: ${findResult.totalResults} Ergebnisse, aber keines mit dieser Dokumentnummer.\n\n` +
                    `Bitte verwende eine alternative Suche oder die direkte URL.`,
                );
              }
            }

            const doc = findResult.document;
            contentUrl = doc.content_urls.html ?? undefined;

            if (!contentUrl) {
              return createMcpResponse(
                `**Fehler:** Keine Inhalts-URL fuer Dokument \`${dokumentnummer}\` verfuegbar.\n\n` +
                  'Das Dokument hat moeglicherweise keinen abrufbaren Volltext.',
              );
            }

            // Build metadata from search result
            metadata = {
              dokumentnummer: doc.dokumentnummer,
              applikation: doc.applikation,
              titel: doc.titel,
              kurztitel: doc.kurztitel,
              citation: {
                kurztitel: doc.citation.kurztitel,
                langtitel: doc.citation.langtitel,
                kundmachungsorgan: doc.citation.kundmachungsorgan,
                paragraph: doc.citation.paragraph,
                eli: doc.citation.eli,
                inkrafttreten: doc.citation.inkrafttreten,
                ausserkrafttreten: doc.citation.ausserkrafttreten,
              },
              dokument_url: doc.dokument_url,
              gesamte_rechtsvorschrift_url: doc.gesamte_rechtsvorschrift_url,
            };
          }
        } else {
          // Only URL provided - minimal metadata
          metadata = {
            dokumentnummer: dokumentnummer ?? 'Unbekannt',
            applikation: 'Unbekannt',
            titel: inputUrl ?? '',
            kurztitel: null,
            citation: {},
            dokument_url: inputUrl,
          };
        }

        if (!contentUrl) {
          return createMcpResponse('**Fehler:** Keine gueltige URL zum Abrufen des Dokuments.');
        }

        // Fetch document content if not already fetched via direct URL
        if (!htmlContent) {
          htmlContent = await getDocumentContent(contentUrl);
        }

        // Format the document
        const formatted = formatDocument(htmlContent, metadata, response_format);
        const result = truncateResponse(formatted);

        return createMcpResponse(result);
      } catch (e) {
        return createMcpResponse(formatErrorResponse(e));
      }
    },
  );
}

ris-mcp

ris_dokument

Instructions

Input Schema

Implementation Reference

Other Tools

Latest Blog Posts

MCP directory API