profound-mcp 0.2.1

package/src/tools/logs/raw/logs-logs-raw.ts

@@ -0,0 +1,186 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'profound-mcp/filtering';
+import { Metadata, asTextContentResult } from 'profound-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Profound from 'profoundai';
+
+export const metadata: Metadata = {
+  resource: 'logs.raw',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/logs/raw',
+  operationId: 'get_logs_v1_logs_raw_post',
+};
+
+export const tool: Tool = {
+  name: 'logs_logs_raw',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet all logs with filters\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/raw_logs_response',\n  $defs: {\n    raw_logs_response: {\n      anyOf: [        {\n          type: 'array',\n          title: 'LogVisitList',\n          items: {\n            type: 'object',\n            title: 'LogVisit',\n            description: 'DB Model for a log visit.',\n            properties: {\n              host: {\n                type: 'string',\n                title: 'Host'\n              },\n              ip: {\n                type: 'string',\n                title: 'Ip'\n              },\n              method: {\n                type: 'string',\n                title: 'Method'\n              },\n              org_id: {\n                type: 'string',\n                title: 'Org Id'\n              },\n              path: {\n                type: 'string',\n                title: 'Path'\n              },\n              status_code: {\n                type: 'integer',\n                title: 'Status Code'\n              },\n              timestamp: {\n                type: 'string',\n                title: 'Timestamp',\n                format: 'date-time'\n              },\n              user_agent: {\n                type: 'string',\n                title: 'User Agent'\n              },\n              bytes_sent: {\n                type: 'integer',\n                title: 'Bytes Sent'\n              },\n              duration_ms: {\n                type: 'integer',\n                title: 'Duration Ms'\n              },\n              query_params: {\n                type: 'object',\n                title: 'Query Params',\n                additionalProperties: true\n              },\n              referer: {\n                type: 'string',\n                title: 'Referer'\n              }\n            },\n            required: [              'host',\n              'ip',\n              'method',\n              'org_id',\n              'path',\n              'status_code',\n              'timestamp',\n              'user_agent'\n            ]\n          }\n        },\n        {\n          $ref: '#/$defs/report_response'\n        }\n      ],\n      title: 'Response Get Logs V1 Logs Raw Post',\n      description: 'Base response model for reports.'\n    },\n    report_response: {\n      type: 'object',\n      title: 'Response',\n      description: 'Base response model for reports.',\n      properties: {\n        data: {\n          type: 'array',\n          title: 'Data',\n          items: {\n            $ref: '#/$defs/report_result'\n          }\n        },\n        info: {\n          $ref: '#/$defs/report_info'\n        }\n      },\n      required: [        'data',\n        'info'\n      ]\n    },\n    report_result: {\n      type: 'object',\n      title: 'Result',\n      description: 'Base model for report results.',\n      properties: {\n        dimensions: {\n          type: 'array',\n          title: 'Dimensions',\n          items: {\n            type: 'string'\n          }\n        },\n        metrics: {\n          type: 'array',\n          title: 'Metrics',\n          items: {\n            type: 'number'\n          }\n        }\n      },\n      required: [        'dimensions',\n        'metrics'\n      ]\n    },\n    report_info: {\n      type: 'object',\n      title: 'Info',\n      description: 'Base model for report information.',\n      properties: {\n        total_rows: {\n          type: 'integer',\n          title: 'Total Rows'\n        },\n        query: {\n          type: 'object',\n          title: 'Query',\n          additionalProperties: true\n        }\n      },\n      required: [        'total_rows'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      domain: {
+        type: 'string',
+        title: 'Domain',
+        description: 'Domain to query logs for.',
+      },
+      metrics: {
+        type: 'array',
+        title: 'Metrics',
+        items: {
+          type: 'string',
+          enum: ['count'],
+        },
+      },
+      start_date: {
+        type: 'string',
+        title: 'Start Date',
+        description:
+          'Start date for logs. Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS, or full ISO timestamp.',
+        format: 'date-time',
+      },
+      date_interval: {
+        type: 'string',
+        title: 'Date Interval',
+        description: 'Date interval for the report. (only used with date dimension)',
+        enum: ['day', 'week', 'month', 'year'],
+      },
+      dimensions: {
+        type: 'array',
+        title: 'Dimensions',
+        description: 'Dimensions to group the report by.',
+        items: {
+          type: 'string',
+          enum: [
+            'timestamp',
+            'method',
+            'host',
+            'path',
+            'status_code',
+            'ip',
+            'user_agent',
+            'referer',
+            'bytes_sent',
+            'duration_ms',
+            'query_params',
+          ],
+        },
+      },
+      end_date: {
+        type: 'string',
+        title: 'End Date',
+        description: 'End date for logs. Accepts same formats as start_date. Defaults to now if omitted.',
+        format: 'date-time',
+      },
+      filters: {
+        type: 'array',
+        title: 'Filters',
+        description: 'List of filters to apply to the report. Each filter has an operator, field, and value.',
+        items: {
+          type: 'object',
+          title:
+            "Filter[Literal['method', 'path', 'status_code', 'ip', 'user_agent', 'referer', 'query_params']]",
+          properties: {
+            field: {
+              type: 'string',
+              title: 'Field',
+              enum: ['method', 'path', 'status_code', 'ip', 'user_agent', 'referer', 'query_params'],
+            },
+            operator: {
+              type: 'string',
+              title: 'Operator',
+              enum: [
+                'is',
+                'not_is',
+                'in',
+                'not_in',
+                'contains',
+                'not_contains',
+                'contains_case_insensitive',
+                'not_contains_case_insensitive',
+                'matches',
+              ],
+            },
+            value: {
+              anyOf: [
+                {
+                  type: 'string',
+                  title: 'FilterStringValue',
+                },
+                {
+                  type: 'array',
+                  title: 'FilterStringListValue',
+                  items: {
+                    type: 'string',
+                  },
+                },
+                {
+                  type: 'integer',
+                  title: 'FilterIntegerValue',
+                },
+                {
+                  type: 'array',
+                  title: 'FilterIntegerListValue',
+                  items: {
+                    type: 'integer',
+                  },
+                },
+              ],
+              title: 'Value',
+              description:
+                'Value for the filter. Can be a single value or a list of depending on the operator.',
+            },
+          },
+          required: ['field', 'operator', 'value'],
+        },
+      },
+      order_by: {
+        type: 'object',
+        title: 'Order By',
+        description:
+          "\nCustom ordering of the report results.\n\nThe order is a record of key-value pairs where:\n- key is the field to order by, which can be a metric or dimension\n- value is the direction of the order, either 'asc' for ascending or 'desc' for descending.\n\nWhen not specified, the default order is the first metric in the query descending.\n        ",
+        additionalProperties: true,
+      },
+      pagination: {
+        $ref: '#/$defs/pagination',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['domain', 'metrics', 'start_date'],
+    $defs: {
+      pagination: {
+        type: 'object',
+        title: 'Pagination',
+        description: 'Report pagination model.',
+        properties: {
+          limit: {
+            type: 'integer',
+            title: 'Limit',
+            description: 'Maximum number of results to return. Default is 10,000, maximum is 50,000.',
+          },
+          offset: {
+            type: 'integer',
+            title: 'Offset',
+            description: 'Offset for the results. Used for pagination.',
+          },
+        },
+      },
+    },
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Profound, args: Record<string, unknown> | undefined) => {
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.logs.raw.logs(body)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/organizations/categories/list-organizations-categories.ts

@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'profound-mcp/filtering';
+import { Metadata, asTextContentResult } from 'profound-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Profound from 'profoundai';
+
+export const metadata: Metadata = {
+  resource: 'organizations.categories',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/org/categories',
+  operationId: 'get_categories_v1_org_categories_get',
+};
+
+export const tool: Tool = {
+  name: 'list_organizations_categories',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet the organization categories.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_list_response',\n  $defs: {\n    category_list_response: {\n      type: 'array',\n      title: 'Response Get Categories V1 Org Categories Get',\n      items: {\n        $ref: '#/$defs/org_item'\n      }\n    },\n    org_item: {\n      type: 'object',\n      title: 'OrgItem',\n      properties: {\n        id: {\n          type: 'string',\n          title: 'Id'\n        },\n        name: {\n          type: 'string',\n          title: 'Name'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Profound, args: Record<string, unknown> | undefined) => {
+  const { jq_filter } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.organizations.categories.list()));
+};
+
+export default { metadata, tool, handler };

package/src/tools/organizations/categories/prompts-organizations-categories.ts

@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'profound-mcp/filtering';
+import { Metadata, asTextContentResult } from 'profound-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Profound from 'profoundai';
+
+export const metadata: Metadata = {
+  resource: 'organizations.categories',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/org/categories/{category_id}/prompts',
+  operationId: 'get_category_prompts_v1_org_categories__category_id__prompts_get',
+};
+
+export const tool: Tool = {
+  name: 'prompts_organizations_categories',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet Category Prompts\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_prompts_response',\n  $defs: {\n    category_prompts_response: {\n      type: 'object',\n      title: 'CategoryPromptsResponse',\n      properties: {\n        data: {\n          type: 'array',\n          title: 'Data',\n          items: {\n            type: 'object',\n            title: 'Prompt',\n            properties: {\n              id: {\n                type: 'string',\n                title: 'Id'\n              },\n              created_at: {\n                type: 'string',\n                title: 'Created At',\n                format: 'date-time'\n              },\n              platforms: {\n                type: 'array',\n                title: 'Platforms',\n                items: {\n                  $ref: '#/$defs/org_item'\n                }\n              },\n              prompt: {\n                type: 'string',\n                title: 'Prompt'\n              },\n              prompt_type: {\n                type: 'string',\n                title: 'Prompt Type'\n              },\n              regions: {\n                type: 'array',\n                title: 'Regions',\n                items: {\n                  $ref: '#/$defs/org_item'\n                }\n              },\n              topic: {\n                $ref: '#/$defs/org_item'\n              },\n              tags: {\n                type: 'array',\n                title: 'Tags',\n                items: {\n                  $ref: '#/$defs/org_item'\n                }\n              }\n            },\n            required: [              'id',\n              'created_at',\n              'platforms',\n              'prompt',\n              'prompt_type',\n              'regions',\n              'topic'\n            ]\n          }\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    org_item: {\n      type: 'object',\n      title: 'OrgItem',\n      properties: {\n        id: {\n          type: 'string',\n          title: 'Id'\n        },\n        name: {\n          type: 'string',\n          title: 'Name'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      category_id: {
+        type: 'string',
+        title: 'Category Id',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['category_id'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Profound, args: Record<string, unknown> | undefined) => {
+  const { category_id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await client.organizations.categories.prompts(category_id)),
+  );
+};
+
+export default { metadata, tool, handler };

package/src/tools/organizations/categories/tags-organizations-categories.ts

@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'profound-mcp/filtering';
+import { Metadata, asTextContentResult } from 'profound-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Profound from 'profoundai';
+
+export const metadata: Metadata = {
+  resource: 'organizations.categories',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/org/categories/{category_id}/tags',
+  operationId: 'get_category_tags_v1_org_categories__category_id__tags_get',
+};
+
+export const tool: Tool = {
+  name: 'tags_organizations_categories',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet the organization tags for a specific category.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_tags_response',\n  $defs: {\n    category_tags_response: {\n      type: 'array',\n      title: 'Response Get Category Tags V1 Org Categories  Category Id  Tags Get',\n      items: {\n        $ref: '#/$defs/org_item'\n      }\n    },\n    org_item: {\n      type: 'object',\n      title: 'OrgItem',\n      properties: {\n        id: {\n          type: 'string',\n          title: 'Id'\n        },\n        name: {\n          type: 'string',\n          title: 'Name'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      category_id: {
+        type: 'string',
+        title: 'Category Id',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['category_id'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Profound, args: Record<string, unknown> | undefined) => {
+  const { category_id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await client.organizations.categories.tags(category_id)),
+  );
+};
+
+export default { metadata, tool, handler };

package/src/tools/organizations/categories/topics-organizations-categories.ts

@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'profound-mcp/filtering';
+import { Metadata, asTextContentResult } from 'profound-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Profound from 'profoundai';
+
+export const metadata: Metadata = {
+  resource: 'organizations.categories',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/org/categories/{category_id}/topics',
+  operationId: 'get_category_topics_v1_org_categories__category_id__topics_get',
+};
+
+export const tool: Tool = {
+  name: 'topics_organizations_categories',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet the organization categories.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_topics_response',\n  $defs: {\n    category_topics_response: {\n      type: 'array',\n      title: 'Response Get Category Topics V1 Org Categories  Category Id  Topics Get',\n      items: {\n        $ref: '#/$defs/org_item'\n      }\n    },\n    org_item: {\n      type: 'object',\n      title: 'OrgItem',\n      properties: {\n        id: {\n          type: 'string',\n          title: 'Id'\n        },\n        name: {\n          type: 'string',\n          title: 'Name'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      category_id: {
+        type: 'string',
+        title: 'Category Id',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['category_id'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Profound, args: Record<string, unknown> | undefined) => {
+  const { category_id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await client.organizations.categories.topics(category_id)),
+  );
+};
+
+export default { metadata, tool, handler };

package/src/tools/organizations/domains-organizations.ts

@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'profound-mcp/filtering';
+import { Metadata, asTextContentResult } from 'profound-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Profound from 'profoundai';
+
+export const metadata: Metadata = {
+  resource: 'organizations',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/org/domains',
+  operationId: 'get_domains_v1_org_domains_get',
+};
+
+export const tool: Tool = {
+  name: 'domains_organizations',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet the organization domains.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/organization_domains_response',\n  $defs: {\n    organization_domains_response: {\n      type: 'array',\n      title: 'Response Get Domains V1 Org Domains Get',\n      items: {\n        type: 'object',\n        title: 'Domain',\n        properties: {\n          id: {\n            type: 'string',\n            title: 'Id'\n          },\n          created_at: {\n            type: 'string',\n            title: 'Created At',\n            format: 'date-time'\n          },\n          name: {\n            type: 'string',\n            title: 'Name'\n          }\n        },\n        required: [          'id',\n          'created_at',\n          'name'\n        ]\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Profound, args: Record<string, unknown> | undefined) => {
+  const { jq_filter } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.organizations.domains()));
+};
+
+export default { metadata, tool, handler };

package/src/tools/organizations/models-organizations.ts

@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'profound-mcp/filtering';
+import { Metadata, asTextContentResult } from 'profound-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Profound from 'profoundai';
+
+export const metadata: Metadata = {
+  resource: 'organizations',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/org/models',
+  operationId: 'get_models_v1_org_models_get',
+};
+
+export const tool: Tool = {
+  name: 'models_organizations',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet the organization models.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/organization_models_response',\n  $defs: {\n    organization_models_response: {\n      type: 'array',\n      title: 'Response Get Models V1 Org Models Get',\n      items: {\n        $ref: '#/$defs/org_item'\n      }\n    },\n    org_item: {\n      type: 'object',\n      title: 'OrgItem',\n      properties: {\n        id: {\n          type: 'string',\n          title: 'Id'\n        },\n        name: {\n          type: 'string',\n          title: 'Name'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Profound, args: Record<string, unknown> | undefined) => {
+  const { jq_filter } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.organizations.models()));
+};
+
+export default { metadata, tool, handler };

package/src/tools/organizations/regions-organizations.ts

@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'profound-mcp/filtering';
+import { Metadata, asTextContentResult } from 'profound-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Profound from 'profoundai';
+
+export const metadata: Metadata = {
+  resource: 'organizations',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/org/regions',
+  operationId: 'get_regions_v1_org_regions_get',
+};
+
+export const tool: Tool = {
+  name: 'regions_organizations',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet the organization regions.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/organization_regions_response',\n  $defs: {\n    organization_regions_response: {\n      type: 'array',\n      title: 'Response Get Regions V1 Org Regions Get',\n      items: {\n        $ref: '#/$defs/org_item'\n      }\n    },\n    org_item: {\n      type: 'object',\n      title: 'OrgItem',\n      properties: {\n        id: {\n          type: 'string',\n          title: 'Id'\n        },\n        name: {\n          type: 'string',\n          title: 'Name'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Profound, args: Record<string, unknown> | undefined) => {
+  const { jq_filter } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.organizations.regions()));
+};
+
+export default { metadata, tool, handler };