fix: route datamate tools through local stdio mcp-engine instead of cloud by altimate-harness-bot[bot] · Pull Request #893 · AltimateAI/altimate-code

altimate-harness-bot · 2026-06-05T06:30:45Z

Problem

DatamateManagerTool.handleAdd() was creating MCP server entries pointing to the cloud MCP server (https://mcpserver.getaltimate.com) because buildMcpConfig() always fell back to DEFAULT_MCP_URL when mcpServerUrl was absent from altimate.json.

The cloud MCP runs in multi-user mode and reads connections from API headers — it has no access to ~/.altimate/connections.json. So any tool call like datamate-remote_jira_get_issue failed with "No connection configured for integration: jira" even when connections were configured locally.

Fix

`datamate.ts` — `handleAdd()`

Replace buildMcpConfig() (HTTP remote) with a local stdio config:

const mcpConfig = {
  type: "local" as const,
  command: ["datamate", "start-stdio", "--datamate", args.datamate_id],
}

Each spawned datamate start-stdio process:

Reads connections.json from ~/.altimate/ directly (local engine, same as VS Code extension)
Discovers the right VS Code extension bridge at runtime via cwd-based sidecar matching in ~/.altimate/extension-rpc/
Multiple VS Code windows are handled correctly — each window's bridge writes a sidecar with its workspaceFolders; the spawned process matches on process.cwd() (set to project root by StdioClientTransport) and routes to the right bridge automatically

`mcp-discover.ts` — `stripSessionEnv()`

When persisting a discovered server via mcp_discover, strip ALTIMATE_EXTENSION_RPC from the environment block before writing to disk. The socket path is session-specific (unique to the current extension host process) — hardcoding it would cause future sessions to connect to a dead or wrong bridge. Stripping it forces runtime discovery.

Prerequisites

Requires the global datamate CLI to be on PATH: npm install -g @altimateai/datamate. The VS Code extension already warns users when stdio mode is configured but no global datamate is found.

Related PRs

AltimateAI/altimate-mcp-engine#211 — writes mcpServerUrl to altimate.json (interim fix, superseded by this approach)
AltimateAI/vscode-altimate-mcp-server#360 — same interim fix for the VS Code extension

Requested by @saravmajestic via harness

Summary by cubic

Route datamate tools through the local MCP engine when the VS Code extension is present, auto-detecting stdio vs HTTP from .vscode/mcp.json, and use a single datamate gateway to avoid duplicate tool sets. Sync the datamate entry by updatedAt (works for stdio and HTTP), add a live reload endpoint, and refresh tools after reconnects.

Bug Fixes
- datamate.ts: detect transport from .vscode/mcp.json; use server name datamate when the extension entry exists (stdio or HTTP), otherwise use per-datamate cloud config; default to enabled: true.
- Local engine reads ~/.altimate/connections.json and auto-selects the right VS Code bridge via cwd-based sidecars; supports multiple windows.
- mcp-discover.ts: strip ALTIMATE_EXTENSION_RPC from persisted env to avoid dead/wrong sockets.
- serve.ts + config.ts: on startup, sync the datamate entry by updatedAt (covers stdio + HTTP); other remote MCP entries sync via URL comparison; persist updatedAt in config.
- server.ts: add POST /altimate/mcp/reload-datamate to re-sync from .vscode/mcp.json and reconnect updated MCP clients without a server restart.
- session/prompt.ts: subscribe to MCP.ToolsChanged and refresh tools on the next turn with trace logs.
- mcp/index.ts: persist enabled/disabled state to config on MCP connect/disconnect so it survives restarts.
Migration
- Ensure the datamate CLI is on PATH: npm install -g @altimateai/datamate.

^{Written for commit 0b6cc26. Summary will update on new commits.}

github-actions · 2026-06-05T06:30:56Z

This PR doesn't fully meet our contributing guidelines and PR template.

What needs to be fixed:

PR description is missing required template sections. Please use the PR template.

Please edit this PR description to address the above within 2 hours, or it will be automatically closed.

If you believe this was flagged incorrectly, please let a maintainer know.

github-actions · 2026-06-05T06:30:57Z

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

Open an issue describing the bug/feature (if one doesn't exist)
Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

github-actions · 2026-06-05T06:31:19Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

altimate-harness-bot · 2026-06-05T07:32:25Z

E2E Verification — PASSED ✓

Full pipeline tested end-to-end in the sandbox:

Test setup:

altimate serve running on port 4097 (bun source, live-reloads PR branch changes)
Mock Altimate backend on port 5001 (returns Jira datamate with type: "tool")
Mock Jira REST API on port 5001 (serves /rest/api/2/issue/AI-6348)
connections.json using type: "server" + jiraBaseUrl: "http://localhost:5001" (avoids need for real credentials)

Results:

✓ Initialized: AltimateMCPStdioServer
✓ Tools: 8 total, 8 Jira tools
   - jira_get_issue, jira_create_issue, jira_get_child_issues,
     jira_add_comment, jira_update_issue_status, jira_get_available_transitions,
     jira_link_issue, jira_get_link_types

→ Calling jira_get_issue(issueIdOrKey: "AI-6348")...

✓ jira_get_issue("AI-6348") SUCCESS!
  key: AI-6348
  summary: feat: Ingest Snowflake TASK_HISTORY / SERVERLESS_TASK_HISTORY / COMPLETE_TASK_GRAPHS...
  status: Done
  assignee: Raghwendra Singh

What was verified:

datamate.ts patch: handleAdd() creates { type: "local", command: ["datamate", "start-stdio", "--datamate", id] } instead of cloud HTTP config
mcp-discover.ts patch: stripSessionEnv() removes ALTIMATE_EXTENSION_RPC before persisting to altimate-code.json — verified environment key absent in written config
Full MCP JSON-RPC stdio handshake: initialize → tools/list (8 tools) → tools/call → real tool response
discoverExternalMcp reads .vscode/mcp.json correctly, transforms stdio entry to { type: "local" }, strips session socket path

github-actions · 2026-06-05T09:43:41Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T09:44:12Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T10:02:53Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T10:03:16Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T10:23:25Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T10:23:50Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T13:03:35Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T13:04:05Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T13:20:25Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T13:20:53Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T13:31:42Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T13:32:20Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T13:53:04Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-05T13:53:49Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-09T01:45:39Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-09T01:46:01Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

- Add stdio transport support for datamate MCP (vs HTTP-only before) - Single-gateway mode: when .vscode/mcp.json has "datamate" key, always use it as server name — prevents duplicate tool sets from extension - syncDatamateUrlFromVscodeMcp: use updatedAt field as change signal for the "datamate" entry (works for both stdio and HTTP), URL comparison for all other remote entries - Strip ALTIMATE_EXTENSION_RPC from persisted mcp-discover configs to avoid stale socket paths across VS Code sessions - persistMcpEnabled: write enabled/disabled flag to disk on MCP connect/disconnect so it survives session restarts - Add /altimate/mcp/reload-datamate endpoint to re-sync and reconnect without full server restart - MCP.ToolsChanged subscription in prompt loop for traceability - Merge main: preserve trace consumer in serve.ts, restore exports on isAnthropicLikeModel and insertReminders

github-actions · 2026-06-09T02:46:23Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

github-actions · 2026-06-09T02:47:00Z

👋 This PR was automatically closed by our quality checks.

Common reasons:

New GitHub account with limited contribution history
PR description doesn't meet our guidelines
Contribution appears to be AI-generated without meaningful review

If you believe this was a mistake, please open an issue explaining your intended contribution and a maintainer will help you.

altimate-harness-bot Bot assigned saravmajestic Jun 5, 2026

github-actions Bot added needs:compliance contributor labels Jun 5, 2026

github-actions Bot added the needs:issue label Jun 5, 2026

github-actions Bot added the needs-review:blocked label Jun 5, 2026

altimate-harness-bot Bot force-pushed the fix/datamate-stdio-local-transport branch from a71092d to 0b6cc26 Compare June 9, 2026 02:46

Conversation

altimate-harness-bot Bot commented Jun 5, 2026 • edited by cubic-dev-ai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Fix

datamate.ts — handleAdd()

mcp-discover.ts — stripSessionEnv()

Prerequisites

Related PRs

Summary by cubic

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

altimate-harness-bot Bot commented Jun 5, 2026

E2E Verification — PASSED ✓

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 5, 2026

Uh oh!

github-actions Bot commented Jun 9, 2026

Uh oh!

github-actions Bot commented Jun 9, 2026

Uh oh!

github-actions Bot commented Jun 9, 2026

Uh oh!

github-actions Bot commented Jun 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

altimate-harness-bot Bot commented Jun 5, 2026 •

edited by cubic-dev-ai Bot

Loading

`datamate.ts` — `handleAdd()`

`mcp-discover.ts` — `stripSessionEnv()`