@cyanheads/reliefweb-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/get-disaster.tool.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Fetch a single ReliefWeb disaster record by ID with full details.
+ * @module mcp-server/tools/definitions/get-disaster
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const reliefwebGetDisaster: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+    glide: z.ZodOptional<z.ZodString>;
+    dateEvent: z.ZodOptional<z.ZodString>;
+    dateCreated: z.ZodOptional<z.ZodString>;
+    primaryCountry: z.ZodOptional<z.ZodString>;
+    countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    primaryType: z.ZodOptional<z.ZodString>;
+    urlAlias: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    profileOverview: z.ZodOptional<z.ZodString>;
+    keyContent: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+    appealsResponsePlans: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+        date: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    usefulLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No disaster found with the given ID.";
+    readonly recovery: "Verify the ID is a valid ReliefWeb numeric disaster ID from reliefweb_search_disasters results.";
+}]>;
+//# sourceMappingURL=get-disaster.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-disaster.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-disaster.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-disaster.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuH/B,CAAC"}

package/dist/mcp-server/tools/definitions/get-disaster.tool.js

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Fetch a single ReliefWeb disaster record by ID with full details.
+ * @module mcp-server/tools/definitions/get-disaster
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getReliefWebService } from '../../../services/reliefweb/reliefweb-service.js';
+export const reliefwebGetDisaster = tool('reliefweb_get_disaster', {
+    title: 'Get ReliefWeb Disaster',
+    description: 'Fetch a disaster record by ReliefWeb numeric ID including description, affected countries, GLIDE number, ' +
+        'profile overview, key content links, and active appeals or response plans. ' +
+        'Use after reliefweb_search_disasters to retrieve full details.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        id: z
+            .number()
+            .int()
+            .positive()
+            .describe('ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results.'),
+    }),
+    output: z.object({
+        id: z.number().describe('ReliefWeb numeric disaster ID.'),
+        name: z.string().describe('Disaster name.'),
+        status: z.string().optional().describe('Disaster status (alert, current, past, archive).'),
+        glide: z.string().optional().describe('GLIDE number for cross-system correlation.'),
+        dateEvent: z.string().optional().describe('Event date (ISO 8601), when available.'),
+        dateCreated: z.string().optional().describe('ReliefWeb index date (ISO 8601).'),
+        primaryCountry: z.string().optional().describe('Primary affected country.'),
+        countries: z.array(z.string()).optional().describe('All countries tagged on this disaster.'),
+        types: z.array(z.string()).optional().describe('Disaster type names.'),
+        primaryType: z.string().optional().describe('Primary disaster type.'),
+        urlAlias: z.string().optional().describe('Canonical ReliefWeb URL for this disaster.'),
+        description: z.string().optional().describe('Full disaster description text.'),
+        profileOverview: z
+            .string()
+            .optional()
+            .describe('Profile overview text from the ReliefWeb editorial team.'),
+        keyContent: z
+            .array(z
+            .object({
+            title: z.string().describe('Link title.'),
+            url: z.string().describe('Link URL.'),
+        })
+            .describe('A curated key content link.'))
+            .optional()
+            .describe('Curated key content links from the ReliefWeb editorial team.'),
+        appealsResponsePlans: z
+            .array(z
+            .object({
+            title: z.string().describe('Appeal or response plan title.'),
+            url: z.string().describe('Link URL.'),
+            date: z.string().optional().describe('Publication date.'),
+        })
+            .describe('An appeal or response plan entry.'))
+            .optional()
+            .describe('Active appeals and response plans linked to this disaster.'),
+        usefulLinks: z
+            .array(z
+            .object({
+            title: z.string().describe('Link title.'),
+            url: z.string().describe('Link URL.'),
+        })
+            .describe('A useful external link.'))
+            .optional()
+            .describe('Useful external links curated by ReliefWeb editors.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No disaster found with the given ID.',
+            recovery: 'Verify the ID is a valid ReliefWeb numeric disaster ID from reliefweb_search_disasters results.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('reliefweb_get_disaster', { id: input.id });
+        const disaster = await getReliefWebService().getDisaster(input.id, ctx);
+        if (!disaster) {
+            throw ctx.fail('not_found', `No disaster found with ID ${input.id}. Verify the ID from reliefweb_search_disasters.`, { ...ctx.recoveryFor('not_found') });
+        }
+        return disaster;
+    },
+    format: (result) => {
+        const lines = [`# ${result.name}`];
+        lines.push(`**ID:** ${result.id}`);
+        if (result.status)
+            lines.push(`**Status:** ${result.status}`);
+        if (result.glide)
+            lines.push(`**GLIDE:** ${result.glide}`);
+        if (result.primaryType)
+            lines.push(`**Primary type:** ${result.primaryType}`);
+        if (result.types?.length)
+            lines.push(`**Types:** ${result.types.join(', ')}`);
+        if (result.dateEvent)
+            lines.push(`**Event date:** ${result.dateEvent}`);
+        if (result.dateCreated)
+            lines.push(`**Indexed:** ${result.dateCreated}`);
+        if (result.primaryCountry)
+            lines.push(`**Primary country:** ${result.primaryCountry}`);
+        if (result.countries?.length)
+            lines.push(`**Countries:** ${result.countries.join(', ')}`);
+        if (result.urlAlias)
+            lines.push(`**URL:** ${result.urlAlias}`);
+        if (result.description)
+            lines.push(`\n## Description\n\n${result.description}`);
+        if (result.profileOverview)
+            lines.push(`\n## Overview\n\n${result.profileOverview}`);
+        if (result.keyContent?.length) {
+            lines.push('\n## Key Content');
+            for (const kc of result.keyContent)
+                lines.push(`- [${kc.title}](${kc.url})`);
+        }
+        if (result.appealsResponsePlans?.length) {
+            lines.push('\n## Appeals & Response Plans');
+            for (const ap of result.appealsResponsePlans) {
+                lines.push(`- [${ap.title}](${ap.url})${ap.date ? ` (${ap.date})` : ''}`);
+            }
+        }
+        if (result.usefulLinks?.length) {
+            lines.push('\n## Useful Links');
+            for (const ul of result.usefulLinks)
+                lines.push(`- [${ul.title}](${ul.url})`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-disaster.tool.js.map

package/dist/mcp-server/tools/definitions/get-disaster.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-disaster.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-disaster.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-report.tool.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Fetch a single ReliefWeb report by ID with full body text and metadata.
+ * @module mcp-server/tools/definitions/get-report
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const reliefwebGetReport: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    dateOriginal: z.ZodOptional<z.ZodString>;
+    dateCreated: z.ZodOptional<z.ZodString>;
+    primaryCountry: z.ZodOptional<z.ZodString>;
+    countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    formats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    themes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    urlAlias: z.ZodOptional<z.ZodString>;
+    fileUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    headlineSummary: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No report found with the given ID.";
+    readonly recovery: "Verify the ID is a valid ReliefWeb numeric ID obtained from search results. Use reliefweb_search_reports to discover valid IDs.";
+}]>;
+//# sourceMappingURL=get-report.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;GAiF7B,CAAC"}

package/dist/mcp-server/tools/definitions/get-report.tool.js

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Fetch a single ReliefWeb report by ID with full body text and metadata.
+ * @module mcp-server/tools/definitions/get-report
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getReliefWebService } from '../../../services/reliefweb/reliefweb-service.js';
+export const reliefwebGetReport = tool('reliefweb_get_report', {
+    title: 'Get ReliefWeb Report',
+    description: 'Fetch a single ReliefWeb report by its numeric ID with full body text, file attachments, and all metadata. ' +
+        'Use after reliefweb_search_reports to retrieve document content — body is excluded from search results to manage context budget. ' +
+        'Report bodies can be 10–100KB; call this only when you need the full document text.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        id: z
+            .number()
+            .int()
+            .positive()
+            .describe('ReliefWeb numeric report ID. Obtained from reliefweb_search_reports results.'),
+    }),
+    output: z.object({
+        id: z.number().describe('ReliefWeb numeric report ID.'),
+        title: z.string().describe('Report title.'),
+        dateOriginal: z.string().optional().describe('Source publication date (ISO 8601).'),
+        dateCreated: z.string().optional().describe('ReliefWeb index date (ISO 8601).'),
+        primaryCountry: z.string().optional().describe('Primary country name for this report.'),
+        countries: z.array(z.string()).optional().describe('All countries tagged on this report.'),
+        sources: z.array(z.string()).optional().describe('Publishing organizations (short names).'),
+        formats: z.array(z.string()).optional().describe('Content format names.'),
+        themes: z.array(z.string()).optional().describe('Humanitarian theme/sector names.'),
+        languages: z.array(z.string()).optional().describe('Language codes (ISO 639-1).'),
+        urlAlias: z.string().optional().describe('Canonical ReliefWeb URL for this report.'),
+        fileUrls: z
+            .array(z.string())
+            .optional()
+            .describe('Direct file download URLs attached to this report.'),
+        headlineSummary: z
+            .string()
+            .optional()
+            .describe('Short editorial summary from the headline block, when present.'),
+        body: z
+            .string()
+            .optional()
+            .describe('Full report body text (HTML). Present for most reports; absent for binary-only documents.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No report found with the given ID.',
+            recovery: 'Verify the ID is a valid ReliefWeb numeric ID obtained from search results. Use reliefweb_search_reports to discover valid IDs.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('reliefweb_get_report', { id: input.id });
+        const report = await getReliefWebService().getReport(input.id, ctx);
+        if (!report) {
+            throw ctx.fail('not_found', `No report found with ID ${input.id}. Verify the ID is a valid ReliefWeb numeric ID.`, { ...ctx.recoveryFor('not_found') });
+        }
+        return report;
+    },
+    format: (result) => {
+        const lines = [`# ${result.title}`];
+        lines.push(`**ID:** ${result.id}`);
+        if (result.dateOriginal)
+            lines.push(`**Published:** ${result.dateOriginal}`);
+        if (result.dateCreated)
+            lines.push(`**Indexed:** ${result.dateCreated}`);
+        if (result.primaryCountry)
+            lines.push(`**Primary country:** ${result.primaryCountry}`);
+        if (result.countries?.length)
+            lines.push(`**Countries:** ${result.countries.join(', ')}`);
+        if (result.sources?.length)
+            lines.push(`**Sources:** ${result.sources.join(', ')}`);
+        if (result.formats?.length)
+            lines.push(`**Format:** ${result.formats.join(', ')}`);
+        if (result.themes?.length)
+            lines.push(`**Themes:** ${result.themes.join(', ')}`);
+        if (result.languages?.length)
+            lines.push(`**Languages:** ${result.languages.join(', ')}`);
+        if (result.headlineSummary)
+            lines.push(`\n**Summary:** ${result.headlineSummary}`);
+        if (result.urlAlias)
+            lines.push(`**URL:** ${result.urlAlias}`);
+        if (result.fileUrls?.length)
+            lines.push(`**Files:** ${result.fileUrls.join(', ')}`);
+        if (result.body)
+            lines.push(`\n---\n\n${result.body}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-report.tool.js.map

package/dist/mcp-server/tools/definitions/get-report.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/list-countries.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview List all countries tracked by ReliefWeb, optionally filtered by crisis status.
+ * @module mcp-server/tools/definitions/list-countries
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const reliefwebListCountries: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    crisis_only: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        iso3: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        urlAlias: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=list-countries.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-countries.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-countries.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-countries.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;6BAwFjC,CAAC"}

package/dist/mcp-server/tools/definitions/list-countries.tool.js

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview List all countries tracked by ReliefWeb, optionally filtered by crisis status.
+ * @module mcp-server/tools/definitions/list-countries
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getReliefWebService } from '../../../services/reliefweb/reliefweb-service.js';
+export const reliefwebListCountries = tool('reliefweb_list_countries', {
+    title: 'List ReliefWeb Countries',
+    description: 'List all countries and territories tracked by ReliefWeb, optionally filtered to active humanitarian situations. ' +
+        'Returns ISO3 codes and status for each entry — use the ISO3 code with reliefweb_get_country to fetch a full profile. ' +
+        'Set crisis_only=true to limit results to countries with active humanitarian situations.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        crisis_only: z
+            .boolean()
+            .optional()
+            .describe('When true, filters to countries with an active humanitarian situation (status alert or current). Default false returns all countries.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .default(100)
+            .describe('Number of results to return (1–1000, default 100). Each call counts against the 1,000-calls/day quota.'),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .default(0)
+            .describe('Zero-based offset for pagination. Use with limit and totalCount to page through results.'),
+    }),
+    output: z.object({
+        items: z
+            .array(z
+            .object({
+            id: z.number().describe('ReliefWeb numeric country ID.'),
+            name: z.string().describe('Country or territory name.'),
+            iso3: z
+                .string()
+                .optional()
+                .describe('ISO 3166-1 alpha-3 code for use with reliefweb_get_country.'),
+            status: z
+                .string()
+                .optional()
+                .describe('Humanitarian situation status. Active situations have status alert or current.'),
+            urlAlias: z
+                .string()
+                .optional()
+                .describe('Canonical ReliefWeb URL for this country page.'),
+        })
+            .describe('A country or territory tracked by ReliefWeb.'))
+            .describe('Countries tracked by ReliefWeb.'),
+        totalCount: z.number().describe('Total countries matching the filter before pagination.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('reliefweb_list_countries', {
+            crisisOnly: input.crisis_only,
+            limit: input.limit,
+        });
+        const result = await getReliefWebService().listCountries({
+            ...(input.crisis_only != null ? { crisisOnly: input.crisis_only } : {}),
+            limit: input.limit,
+            offset: input.offset,
+        }, ctx);
+        return { items: result.items, totalCount: result.totalCount };
+    },
+    format: (result) => {
+        const lines = [`**Total:** ${result.totalCount} countries`];
+        for (const item of result.items) {
+            const parts = [`**${item.name}**`];
+            if (item.iso3)
+                parts.push(`(${item.iso3})`);
+            parts.push(`[${item.id}]`);
+            if (item.status)
+                parts.push(`— ${item.status}`);
+            if (item.urlAlias)
+                parts.push(`— ${item.urlAlias}`);
+            lines.push(`- ${parts.join(' ')}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=list-countries.tool.js.map

package/dist/mcp-server/tools/definitions/list-countries.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-countries.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-countries.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,0BAA0B,EAAE;IACrE,KAAK,EAAE,0BAA0B;IACjC,WAAW,EACT,kHAAkH;QAClH,uHAAuH;QACvH,yFAAyF;IAC3F,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,WAAW,EAAE,CAAC;aACX,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,uIAAuI,CACxI;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,IAAI,CAAC;aACT,OAAO,CAAC,GAAG,CAAC;aACZ,QAAQ,CACP,wGAAwG,CACzG;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CACP,0FAA0F,CAC3F;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACvD,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6DAA6D,CAAC;YAC1E,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,gFAAgF,CACjF;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gDAAgD,CAAC;SAC9D,CAAC;aACD,QAAQ,CAAC,8CAA8C,CAAC,CAC5D;aACA,QAAQ,CAAC,iCAAiC,CAAC;QAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;KAC1F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACvC,UAAU,EAAE,KAAK,CAAC,WAAW;YAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,EAAE,CAAC,aAAa,CACtD;YACE,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,EACD,GAAG,CACJ,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,CAAC,cAAc,MAAM,CAAC,UAAU,YAAY,CAAC,CAAC;QACtE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,KAAK,GAAa,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YAC3B,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAChD,IAAI,IAAI,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/list-sources.tool.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Browse source organizations that contribute content to ReliefWeb.
+ * @module mcp-server/tools/definitions/list-sources
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const reliefwebListSources: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        shortname: z.ZodOptional<z.ZodString>;
+        types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        url: z.ZodOptional<z.ZodString>;
+        homepage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=list-sources.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-sources.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-sources.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-sources.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;6BAyF/B,CAAC"}

package/dist/mcp-server/tools/definitions/list-sources.tool.js

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview Browse source organizations that contribute content to ReliefWeb.
+ * @module mcp-server/tools/definitions/list-sources
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getReliefWebService } from '../../../services/reliefweb/reliefweb-service.js';
+export const reliefwebListSources = tool('reliefweb_list_sources', {
+    title: 'List ReliefWeb Sources',
+    description: 'Browse source organizations that contribute content to ReliefWeb, optionally filtered by name text or organization type. ' +
+        'Returns short names, types, and URLs. ' +
+        'Use the shortname value with the source filter in reliefweb_search_reports, reliefweb_search_jobs, and reliefweb_search_training.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        text: z
+            .string()
+            .optional()
+            .describe('Full-text search query. Matches against organization name and short name.'),
+        type: z
+            .string()
+            .optional()
+            .describe('Organization type (e.g., Government, International Organization, NGO, Academia). Filters on type.name.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .default(10)
+            .describe('Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.'),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .default(0)
+            .describe('Zero-based offset for pagination. Use with limit and totalCount to page through results.'),
+    }),
+    output: z.object({
+        items: z
+            .array(z
+            .object({
+            id: z.number().describe('ReliefWeb numeric source ID.'),
+            name: z.string().describe('Full organization name.'),
+            shortname: z
+                .string()
+                .optional()
+                .describe('Organization short name — use this value in the source filter for other search tools.'),
+            types: z.array(z.string()).optional().describe('Organization type names.'),
+            url: z.string().optional().describe('Organization ReliefWeb profile URL.'),
+            homepage: z.string().optional().describe('Organization website URL.'),
+        })
+            .describe('A source organization contributing content to ReliefWeb.'))
+            .describe('Source organizations contributing content to ReliefWeb.'),
+        totalCount: z.number().describe('Total sources matching the query before pagination.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('reliefweb_list_sources', {
+            text: input.text,
+            type: input.type,
+            limit: input.limit,
+        });
+        const result = await getReliefWebService().listSources({
+            ...(input.text?.trim() ? { text: input.text } : {}),
+            ...(input.type?.trim() ? { type: input.type } : {}),
+            limit: input.limit,
+            offset: input.offset,
+        }, ctx);
+        return { items: result.items, totalCount: result.totalCount };
+    },
+    format: (result) => {
+        const lines = [`**Total:** ${result.totalCount} sources`];
+        for (const item of result.items) {
+            const namePart = item.shortname ? `**${item.shortname}** — ${item.name}` : `**${item.name}**`;
+            const typePart = item.types?.length ? ` (${item.types.join(', ')})` : '';
+            lines.push(`- ${namePart} [${item.id}]${typePart}`);
+            if (item.homepage)
+                lines.push(`  Website: ${item.homepage}`);
+            if (item.url)
+                lines.push(`  ReliefWeb: ${item.url}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=list-sources.tool.js.map

package/dist/mcp-server/tools/definitions/list-sources.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-sources.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-sources.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/search-disasters.tool.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Search ReliefWeb disasters by type, country, status, and GLIDE number.
+ * @module mcp-server/tools/definitions/search-disasters
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const reliefwebSearchDisasters: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    disaster_type: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    glide: z.ZodOptional<z.ZodString>;
+    date_from: z.ZodOptional<z.ZodString>;
+    date_to: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+    include_archived: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        glide: z.ZodOptional<z.ZodString>;
+        dateEvent: z.ZodOptional<z.ZodString>;
+        dateCreated: z.ZodOptional<z.ZodString>;
+        primaryCountry: z.ZodOptional<z.ZodString>;
+        countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        primaryType: z.ZodOptional<z.ZodString>;
+        urlAlias: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=search-disasters.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-disasters.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-disasters.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-disasters.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA0KnC,CAAC"}