Environments

Preview what an environment resolves to

Resolve an environment to the exact execution inputs a run would use right now: the host’s current config, the closed server set (including servers contributed by pinned plugin versions), and the resolved plugin versions. Returns 409 when the environment cannot currently produce a runnable configuration — for example a pinned plugin was disabled or deleted; details.code carries the specific reason (ENV_PLUGIN_UNAVAILABLE, ENV_NO_SERVERS, ENV_HOST_MISSING, …).

GET

projects

{projectId}

environments

{environmentId}

resolve

Preview what an environment resolves to

curl --request GET \
  --url https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "environment": {
    "id": "<string>",
    "name": "<string>",
    "revision": 123
  },
  "hostId": "<string>",
  "hostName": "<string>",
  "hostConfigId": "<string>",
  "selectedServerIds": [
    "<string>"
  ],
  "effectiveServerIds": [
    "<string>"
  ],
  "pluginVersions": [
    {
      "pluginId": "<string>",
      "pluginVersionId": "<string>",
      "name": "<string>",
      "bundleHash": "<string>"
    }
  ],
  "servers": [
    {
      "serverId": "<string>",
      "name": "<string>"
    }
  ],
  "serverAttachmentId": "<string>"
}

Authorizations

Authorization

string

header

required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId

string

required

ID of the hosted project that contains the server.

environmentId

string

required

Project environment ID, as returned by the project's environment list.

Response

The resolved execution inputs.

What an environment resolves to right now — the same resolution an eval run performs.

environment

object

required

Show child attributes

hostId

string

required

hostName

string

required

hostConfigId

string

required

The host's config at resolve time — hosts rotate configs live, so this can change without the environment's revision changing.

selectedServerIds

string[]

required

The closed non-plugin server set.

effectiveServerIds

string[]

required

selectedServerIds plus the servers contributed by pinned plugin versions — the set a run actually connects. Identical to selectedServerIds when no plugins are pinned.

pluginVersions

object[]

required

The resolved plugin version pins, in pin order.

Show child attributes

servers

object[]

required

Connectable projection of effectiveServerIds, healed to the current live servers.

Show child attributes

serverAttachmentId

string

Archive an environmentArchive an environment. It stops being selectable for runs and frees its name for a new one, but the row is kept and can be restored — this is why archive is a sub-action rather than a DELETE. Requires `expectedRevision` — the revision you last read. If the environment changed since, the write is rejected with 409 rather than overwriting the concurrent edit. Requires project admin.

⌘I

Preview what an environment resolves to

curl --request GET \
  --url https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/environments/{environmentId}/resolve")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "environment": {
    "id": "<string>",
    "name": "<string>",
    "revision": 123
  },
  "hostId": "<string>",
  "hostName": "<string>",
  "hostConfigId": "<string>",
  "selectedServerIds": [
    "<string>"
  ],
  "effectiveServerIds": [
    "<string>"
  ],
  "pluginVersions": [
    {
      "pluginId": "<string>",
      "pluginVersionId": "<string>",
      "name": "<string>",
      "bundleHash": "<string>"
    }
  ],
  "servers": [
    {
      "serverId": "<string>",
      "name": "<string>"
    }
  ],
  "serverAttachmentId": "<string>"
}

API Guides

Endpoints

Preview what an environment resolves to

Authorizations

Path Parameters

Response