Jungle Grid MCP Server

Thin MCP gateway for Jungle Grid. The server exposes agent-facing tools for ChatGPT, Cursor, Claude, and other MCP clients, then forwards all real work to the main Jungle Grid API.

This repo does not schedule jobs, choose providers, calculate billing, or store artifacts. Those responsibilities stay in the Jungle Grid API.

Endpoints

• POST /mcp - MCP Streamable HTTP endpoint
• GET /.well-known/oauth-protected-resource - OAuth protected resource metadata
• GET /healthz - health check

Production URL:

https://mcp.junglegrid.dev/mcp

Environment

PORT=3000
JUNGLEGRID_API_BASE=https://api.junglegrid.dev
JUNGLEGRID_INTERNAL_SERVICE_TOKEN=...
OAUTH_ISSUER=https://api.junglegrid.dev
MCP_RESOURCE=https://mcp.junglegrid.dev
MCP_RESOURCE_METADATA_URL=https://mcp.junglegrid.dev/.well-known/oauth-protected-resource
NODE_ENV=production

Hosted HTTP MCP requires Authorization: Bearer <OAuth access token>. The server introspects that token with the Jungle Grid API, enforces tool scopes, and forwards the user token to the API. JUNGLEGRID_INTERNAL_SERVICE_TOKEN is used only for MCP-to-API introspection and other internal server-to-server calls; it is not used as the ChatGPT user identity.

Legacy aliases are still accepted for stdio compatibility:

• JUNGLE_GRID_API_URL as an alias for JUNGLEGRID_API_BASE
• JUNGLE_GRID_API_KEY as a final auth fallback for local stdio use

Local Development

npm install
npm test
npm run build

Run the hosted HTTP server:

JUNGLEGRID_API_BASE=https://api.junglegrid.dev \
JUNGLEGRID_INTERNAL_SERVICE_TOKEN=... \
npm start

Then check:

curl http://localhost:3000/healthz

MCP Tools

• estimate_job - read-only estimate or execution-plan preparation.
• submit_job - starts real Jungle Grid compute and may cost money.
• get_job - read-only job state lookup.
• get_job_logs - read-only recent log fetch.
• cancel_job - real cancellation action that may stop running compute.
• list_artifacts - read-only managed artifact listing.
• get_artifact - creates a temporary signed artifact download URL.

All tools return a useful text summary and preserve the raw Jungle Grid API response in structuredContent.data.

Connecting Clients

For hosted MCP clients that support Streamable HTTP, use:

https://mcp.junglegrid.dev/mcp

ChatGPT and other hosted clients should discover auth from /.well-known/oauth-protected-resource, connect the user's Jungle Grid account, and then send the OAuth access token as Authorization: Bearer ....

Claude Desktop / Cursor Stdio Compatibility

The package still supports local stdio mode for existing MCP host configs. The bin defaults to stdio; npm start and Docker use HTTP mode.

Claude Desktop example:

{
  "mcpServers": {
    "junglegrid": {
      "command": "npx",
      "args": ["-y", "@jungle-grid/mcp"],
      "env": {
        "JUNGLEGRID_API_BASE": "https://api.junglegrid.dev",
        "JUNGLE_GRID_API_KEY": "jg_..."
      }
    }
  }
}

For Cursor project configs, avoid committing secrets. Put the token in the environment used to launch Cursor and keep checked-in config secret-free.

Docker

docker build -t junglegrid-mcp .
docker run --rm -p 3000:3000 \
  -e PORT=3000 \
  -e JUNGLEGRID_API_BASE=https://api.junglegrid.dev \
  -e JUNGLEGRID_INTERNAL_SERVICE_TOKEN=... \
  junglegrid-mcp

Publishing

npm run build
npm pack --dry-run
npm publish --access public