@cyanheads/interpro-mcp-server 0.0.0-stage → 0.1.2

package/dist/services/interpro/schemas.js

@@ -0,0 +1,226 @@
+/**
+ * @fileoverview Lossless InterPro wire schemas and shared input vocabulary.
+ * @module services/interpro/schemas
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** JSON values retained verbatim from upstream records. */
+export const JsonValueSchema = z.json().describe('An unmodified JSON value.');
+/** An upstream object with every additional JSON field retained. */
+export const JsonObjectSchema = z
+    .record(z.string(), JsonValueSchema)
+    .describe('Complete upstream JSON object.');
+/** Supported entry API routes, including separate PROSITE pattern and profile routes. */
+export const SourceDatabaseSchema = z
+    .enum([
+    'interpro',
+    'pfam',
+    'prosite',
+    'profile',
+    'smart',
+    'cdd',
+    'panther',
+    'cathgene3d',
+    'ssf',
+    'ncbifam',
+    'hamap',
+    'prints',
+    'pirsf',
+    'sfld',
+    'antifam',
+])
+    .describe('InterPro entry API database slug.');
+/** Entry annotation categories. */
+export const EntryTypeSchema = z
+    .enum([
+    'domain',
+    'family',
+    'repeat',
+    'homologous_superfamily',
+    'active_site',
+    'binding_site',
+    'conserved_site',
+    'ptm',
+    'region',
+    'coiled_coil',
+    'disordered',
+])
+    .describe('Entry annotation type.');
+/** A blank or whitespace-only string from a form client reads as omitted. */
+const omitBlank = (value) => typeof value === 'string' && value.trim() === '' ? undefined : value;
+/** Form clients may submit blank optional strings. */
+export const optionalString = (schema) => z.preprocess(omitBlank, schema.optional());
+/** A blank string takes the `.default()` that `schema` declares, as an omitted one does. */
+export const defaultedString = (schema) => z.preprocess(omitBlank, schema);
+/** Safe identifiers are encoded as a single path segment after validation. */
+export const AccessionSchema = z
+    .string()
+    .trim()
+    .min(1)
+    .max(100)
+    .regex(/^[A-Za-z0-9_.:-]+$/)
+    .refine((value) => value !== '.' && value !== '..', 'Dot segments are not accessions.')
+    .describe('Identifier encoded as one path segment; no URL syntax.');
+/**
+ * Whether an upstream value is exactly an accession, the only form server-written text may name
+ * it in. The schema trims, so a value padded with blank lines must not pass as one.
+ */
+export const isAccession = (value) => typeof value === 'string' && AccessionSchema.safeParse(value).data === value;
+/** Canonical UniProt accessions exclude isoform suffixes. */
+export const ProteinAccessionSchema = z
+    .string()
+    .trim()
+    .regex(/^(?:[OPQ][0-9][A-Z0-9]{3}[0-9]|[A-NR-Z][0-9](?:[A-Z][A-Z0-9]{2}[0-9]){1,2})$/i)
+    .describe('Canonical six- or ten-character UniProt accession, without an isoform suffix.');
+/** GO annotation returned by InterPro. */
+export const GoTermSchema = z
+    .object({
+    identifier: z.string().describe('GO identifier.'),
+    name: z.string().describe('GO term name.'),
+    category: z
+        .object({
+        code: z.string().describe('GO category code.'),
+        name: z.string().describe('GO category name.'),
+    })
+        .catchall(JsonValueSchema)
+        .describe('GO category.'),
+})
+    .catchall(JsonValueSchema)
+    .describe('GO annotation.');
+/** Sparse list metadata; only routing fields are required. */
+export const EntrySummarySchema = z
+    .object({
+    accession: z.string().describe('Entry accession.'),
+    source_database: z.string().describe('Upstream source database.'),
+    name: z.string().nullable().optional().describe('Entry name when supplied.'),
+    type: z.string().nullable().optional().describe('Entry type when supplied.'),
+    integrated: z.string().nullable().optional().describe('Integrated InterPro accession.'),
+    member_databases: z
+        .record(z.string(), z.record(z.string(), z.string()))
+        .nullable()
+        .optional()
+        .describe('Member signatures grouped by database.'),
+    go_terms: z.array(GoTermSchema).nullable().optional().describe('GO annotations when supplied.'),
+})
+    .catchall(JsonValueSchema);
+/** Detail metadata differs from summary metadata: names are objects. */
+export const EntryMetadataSchema = z
+    .object({
+    accession: z.string().describe('Entry accession.'),
+    source_database: z.string().describe('Upstream database.'),
+    name: z
+        .object({
+        name: z.string().nullable().optional().describe('Full name.'),
+        short: z.string().nullable().optional().describe('Short name.'),
+    })
+        .catchall(JsonValueSchema)
+        .nullable()
+        .optional()
+        .describe('Detail name object.'),
+})
+    .catchall(JsonValueSchema);
+/** Detail-only output adds readable text without changing upstream description fields. */
+export const EntryDetailMetadataSchema = EntryMetadataSchema.extend({
+    descriptionText: z
+        .string()
+        .optional()
+        .describe('Readable description text decoded from source HTML fragments; absent without textual content.'),
+});
+/** Complete location fragments retain discontinuity and arbitrary annotations. */
+export const LocationSchema = z
+    .object({
+    fragments: z
+        .array(z
+        .object({
+        start: z.number().int().positive().describe('Inclusive 1-based start residue.'),
+        end: z.number().int().positive().describe('Inclusive 1-based end residue.'),
+        'dc-status': z.string().optional().describe('Discontinuity status.'),
+    })
+        .catchall(JsonValueSchema)
+        .refine((fragment) => fragment.start <= fragment.end, 'Fragment start exceeds end.')
+        .describe('Complete continuous or discontinuous sequence fragment.'))
+        .min(1)
+        .describe('Nonempty sequence fragments.'),
+    representative: z.boolean().nullable().optional().describe('Representative match flag.'),
+    model: z.string().nullable().optional().describe('Source model.'),
+    score: z.number().nullable().optional().describe('Upstream match score.'),
+})
+    .catchall(JsonValueSchema)
+    .describe('Complete upstream match location.');
+/** Protein metadata preserves omitted annotations and additional source fields. */
+export const ProteinMetadataSchema = z
+    .object({
+    accession: z.string().describe('Protein accession.'),
+    length: z.number().int().positive().describe('Sequence length in residues.'),
+    source_database: z.string().describe('Protein source database.'),
+    name: z.string().nullable().optional().describe('Protein name.'),
+    gene: z.string().nullable().optional().describe('Gene name.'),
+    source_organism: z
+        .object({
+        taxId: z
+            .union([
+            z.string().describe('Taxonomy identifier as supplied text.'),
+            z.number().int().describe('Taxonomy identifier as supplied integer.'),
+        ])
+            .describe('Taxonomy identifier.'),
+        scientificName: z.string().describe('Scientific organism name.'),
+        fullName: z.string().nullable().optional().describe('Full organism name.'),
+    })
+        .catchall(JsonValueSchema)
+        .optional()
+        .describe('Source organism.'),
+})
+    .catchall(JsonValueSchema);
+/** Protein match rows retain complete nested source records. */
+export const MatchSchema = z
+    .object({
+    metadata: EntrySummarySchema.describe('Entry metadata.'),
+    proteins: z
+        .array(z
+        .object({
+        accession: z.string().describe('Matched protein accession.'),
+        entry_protein_locations: z
+            .array(LocationSchema)
+            .min(1)
+            .describe('Complete match locations.'),
+    })
+        .catchall(JsonValueSchema)
+        .describe('Complete protein match object.'))
+        .min(1)
+        .describe('Protein match objects.'),
+})
+    .catchall(JsonValueSchema);
+/** Feature-keyed extra annotations, not a protein detail envelope. */
+export const ExtraFeaturesSchema = z.record(z.string(), z
+    .object({
+    accession: z.string().describe('Feature accession.'),
+    source_database: z.string().describe('Feature source.'),
+    locations: z.array(LocationSchema).describe('Feature locations.'),
+})
+    .catchall(JsonValueSchema));
+/** Standard list envelope; callers select the operation-specific row schema. */
+export const listSchema = (row) => z
+    .object({
+    count: z.number().int().nonnegative().describe('Total matching records.'),
+    next: z.string().nullable().describe('Upstream continuation URL.'),
+    previous: z.string().nullable().describe('Upstream previous URL.'),
+    results: z.array(row).describe('Current page records.'),
+})
+    .catchall(JsonValueSchema);
+/** Detail response envelope. */
+export const detailSchema = (metadata) => z.object({ metadata: metadata.describe('Complete detail metadata.') }).catchall(JsonValueSchema);
+/** Server-owned page metadata. */
+export const PageSchema = z.object({
+    total: z.number().int().nonnegative().describe('Upstream total records.'),
+    returned: z.number().int().nonnegative().describe('Records returned in this page.'),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .describe('Effective page size after clamping to the tool maximum.'),
+    hasMore: z.boolean().describe('Whether upstream advertises continuation.'),
+    nextCursor: z
+        .string()
+        .optional()
+        .describe('Opaque continuation with unchanged target and filters.'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/services/interpro/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/services/interpro/schemas.ts"],"names":[],"mappings":"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"}

package/dist/services/interpro/upstream-errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Error contracts for upstream failures the service raises identically for every tool.
+ * @module services/interpro/upstream-errors
+ */
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+/** Declared upstream failures every tool shares; spread after `upstream_shape_invalid`. */
+export declare const UPSTREAM_ERRORS: readonly [{
+    readonly reason: 'upstream_response_too_large';
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: 'An upstream response exceeds 4 MiB.';
+    readonly retryable: false;
+    readonly recovery: 'Retry list tools with a smaller limit, or retrieve individual members with interpro_get_entry instead of a large clan.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_rejected';
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: 'InterPro returns an unhandled redirect or client rejection.';
+    readonly retryable: false;
+    readonly recovery: 'Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_unavailable';
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: 'InterPro has a network or server failure; HTTP 501 is not retryable.';
+    readonly retryable: true;
+    readonly recovery: 'Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_timeout';
+    readonly code: JsonRpcErrorCode.Timeout;
+    readonly when: 'InterPro returns HTTP 408/504 or an attempt exceeds its deadline.';
+    readonly retryable: true;
+    readonly recovery: 'Retry with a smaller limit where available, then repeat the same tool after waiting.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_rate_limited';
+    readonly code: JsonRpcErrorCode.RateLimited;
+    readonly when: 'InterPro returns HTTP 429.';
+    readonly retryable: true;
+    readonly recovery: 'Wait for retryAfter when supplied, then repeat the same tool with fewer concurrent calls.';
+    readonly thrownBy: 'service';
+}];
+//# sourceMappingURL=upstream-errors.d.ts.map

package/dist/services/interpro/upstream-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-errors.d.ts","sourceRoot":"","sources":["../../../src/services/interpro/upstream-errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,2FAA2F;AAC3F,eAAO,MAAM,eAAe;aAExB,MAAM,EAAE,6BAA6B;aACrC,IAAI;aACJ,IAAI,EAAE,qCAAqC;aAC3C,SAAS;aACT,QAAQ,EACN,wHAAwH;aAC1H,QAAQ,EAAE,SAAS;;aAGnB,MAAM,EAAE,mBAAmB;aAC3B,IAAI;aACJ,IAAI,EAAE,6DAA6D;aACnE,SAAS;aACT,QAAQ,EACN,4GAA4G;aAC9G,QAAQ,EAAE,SAAS;;aAGnB,MAAM,EAAE,sBAAsB;aAC9B,IAAI;aACJ,IAAI,EAAE,sEAAsE;aAC5E,SAAS;aACT,QAAQ,EACN,4GAA4G;aAC9G,QAAQ,EAAE,SAAS;;aAGnB,MAAM,EAAE,kBAAkB;aAC1B,IAAI;aACJ,IAAI,EAAE,mEAAmE;aACzE,SAAS;aACT,QAAQ,EACN,sFAAsF;aACxF,QAAQ,EAAE,SAAS;;aAGnB,MAAM,EAAE,uBAAuB;aAC/B,IAAI;aACJ,IAAI,EAAE,4BAA4B;aAClC,SAAS;aACT,QAAQ,EACN,2FAA2F;aAC7F,QAAQ,EAAE,SAAS;EAEb,CAAC"}

package/dist/services/interpro/upstream-errors.js

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Error contracts for upstream failures the service raises identically for every tool.
+ * @module services/interpro/upstream-errors
+ */
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+/** Declared upstream failures every tool shares; spread after `upstream_shape_invalid`. */
+export const UPSTREAM_ERRORS = [
+    {
+        reason: 'upstream_response_too_large',
+        code: JsonRpcErrorCode.ServiceUnavailable,
+        when: 'An upstream response exceeds 4 MiB.',
+        retryable: false,
+        recovery: 'Retry list tools with a smaller limit, or retrieve individual members with interpro_get_entry instead of a large clan.',
+        thrownBy: 'service',
+    },
+    {
+        reason: 'upstream_rejected',
+        code: JsonRpcErrorCode.ServiceUnavailable,
+        when: 'InterPro returns an unhandled redirect or client rejection.',
+        retryable: false,
+        recovery: 'Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.',
+        thrownBy: 'service',
+    },
+    {
+        reason: 'upstream_unavailable',
+        code: JsonRpcErrorCode.ServiceUnavailable,
+        when: 'InterPro has a network or server failure; HTTP 501 is not retryable.',
+        retryable: true,
+        recovery: 'Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.',
+        thrownBy: 'service',
+    },
+    {
+        reason: 'upstream_timeout',
+        code: JsonRpcErrorCode.Timeout,
+        when: 'InterPro returns HTTP 408/504 or an attempt exceeds its deadline.',
+        retryable: true,
+        recovery: 'Retry with a smaller limit where available, then repeat the same tool after waiting.',
+        thrownBy: 'service',
+    },
+    {
+        reason: 'upstream_rate_limited',
+        code: JsonRpcErrorCode.RateLimited,
+        when: 'InterPro returns HTTP 429.',
+        retryable: true,
+        recovery: 'Wait for retryAfter when supplied, then repeat the same tool with fewer concurrent calls.',
+        thrownBy: 'service',
+    },
+];
+//# sourceMappingURL=upstream-errors.js.map

package/dist/services/interpro/upstream-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-errors.js","sourceRoot":"","sources":["../../../src/services/interpro/upstream-errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,2FAA2F;AAC3F,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;QACE,MAAM,EAAE,6BAA6B;QACrC,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;QACzC,IAAI,EAAE,qCAAqC;QAC3C,SAAS,EAAE,KAAK;QAChB,QAAQ,EACN,wHAAwH;QAC1H,QAAQ,EAAE,SAAS;KACpB;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;QACzC,IAAI,EAAE,6DAA6D;QACnE,SAAS,EAAE,KAAK;QAChB,QAAQ,EACN,4GAA4G;QAC9G,QAAQ,EAAE,SAAS;KACpB;IACD;QACE,MAAM,EAAE,sBAAsB;QAC9B,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;QACzC,IAAI,EAAE,sEAAsE;QAC5E,SAAS,EAAE,IAAI;QACf,QAAQ,EACN,4GAA4G;QAC9G,QAAQ,EAAE,SAAS;KACpB;IACD;QACE,MAAM,EAAE,kBAAkB;QAC1B,IAAI,EAAE,gBAAgB,CAAC,OAAO;QAC9B,IAAI,EAAE,mEAAmE;QACzE,SAAS,EAAE,IAAI;QACf,QAAQ,EACN,sFAAsF;QACxF,QAAQ,EAAE,SAAS;KACpB;IACD;QACE,MAAM,EAAE,uBAAuB;QAC/B,IAAI,EAAE,gBAAgB,CAAC,WAAW;QAClC,IAAI,EAAE,4BAA4B;QAClC,SAAS,EAAE,IAAI;QACf,QAAQ,EACN,2FAA2F;QAC7F,QAAQ,EAAE,SAAS;KACpB;CACO,CAAC"}

package/package.json

@@ -1,6 +1,106 @@
 {
   "name": "@cyanheads/interpro-mcp-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.2",
+  "mcpName": "io.github.cyanheads/interpro-mcp-server",
+  "description": "Search InterPro entries, map protein domains and functional sites, and find proteins by domain via MCP. STDIO or Streamable HTTP.",
+  "author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
+  "homepage": "https://github.com/cyanheads/interpro-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/cyanheads/interpro-mcp-server/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/cyanheads"
+    },
+    {
+      "type": "buy_me_a_coffee",
+      "url": "https://www.buymeacoffee.com/cyanheads"
+    }
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "interpro-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "!dist/*.mcpb",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "audit:fix": "bun audit fix",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write .",
+    "format:unsafe": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/interpro-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/interpro-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "release:github": "bun run scripts/release-github.ts",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "start": "node dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agents",
+    "ai-tools",
+    "typescript",
+    "cyanheads",
+    "interpro",
+    "pfam",
+    "protein-domains",
+    "bioinformatics"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/interpro-mcp-server.git"
+  },
+  "license": "Apache-2.0",
+  "packageManager": "bun@1.4.4",
+  "engines": {
+    "bun": ">=1.4.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.13.15",
+    "htmlparser2": "^12.0.0",
+    "pino-pretty": "^13.2.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.15",
+    "@socketsecurity/bun-security-scanner": "^1.1.3",
+    "@types/node": "26.6.5",
+    "@vitest/coverage-istanbul": "5.0.5",
+    "depcheck": "^1.4.7",
+    "fast-check": "^4.10.2",
+    "ignore": "^7.0.13",
+    "tsc-alias": "^1.9.8",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  }
+}

package/server.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cyanheads/interpro-mcp-server",
+  "description": "Search InterPro entries, map protein domains and functional sites, and find proteins by domain.",
+  "repository": {
+    "url": "https://github.com/cyanheads/interpro-mcp-server",
+    "source": "github"
+  },
+  "version": "0.1.2",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://interpro.caseyjhand.com/mcp"
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/interpro-mcp-server",
+      "runtimeHint": "npx",
+      "version": "0.1.2",
+      "environmentVariables": [
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/interpro-mcp-server",
+      "runtimeHint": "npx",
+      "version": "0.1.2",
+      "environmentVariables": [
+        {
+          "name": "MCP_TRANSPORT_TYPE",
+          "description": "Selects the HTTP transport.",
+          "format": "string",
+          "value": "http"
+        },
+        {
+          "name": "MCP_HTTP_HOST",
+          "description": "The hostname for the HTTP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "MCP_HTTP_PORT",
+          "description": "The port to run the HTTP server on.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3010"
+        },
+        {
+          "name": "MCP_HTTP_ENDPOINT_PATH",
+          "description": "The endpoint path for the MCP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "/mcp"
+        },
+        {
+          "name": "MCP_AUTH_MODE",
+          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:3010/mcp"
+      }
+    }
+  ]
+}