Servers
Diff two server revisions
Compares from (default: the revision before) with revisionNumber: tools added and removed with their definitions, tools changed with the fields that moved and both definitions, and each changed server info field with both values. Revision 1 has nothing before it, so diffing it needs from. A field in droppedFields was not stored on that side, so a change to it is not established.
GET
/
projects
/
{projectId}
/
servers
/
{serverId}
/
revisions
/
{revisionNumber}
/
diff
Diff two server revisions
curl --request GET \
--url https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/revisions/{revisionNumber}/diff \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/revisions/{revisionNumber}/diff"
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}/servers/{serverId}/revisions/{revisionNumber}/diff', 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}/servers/{serverId}/revisions/{revisionNumber}/diff",
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}/servers/{serverId}/revisions/{revisionNumber}/diff"
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}/servers/{serverId}/revisions/{revisionNumber}/diff")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/revisions/{revisionNumber}/diff")
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{
"from": {
"revisionNumber": 2,
"capturedAt": 123,
"source": "connect",
"sourceId": "<string>",
"counts": {
"tools": 123,
"prompts": 123,
"resources": 123,
"resourceTemplates": 123
}
},
"to": {
"revisionNumber": 2,
"capturedAt": 123,
"source": "connect",
"sourceId": "<string>",
"counts": {
"tools": 123,
"prompts": 123,
"resources": 123,
"resourceTemplates": 123
}
},
"tools": {
"added": [
{
"name": "<string>",
"title": "<string>",
"description": "<string>",
"inputSchema": "<unknown>",
"outputSchema": "<unknown>",
"meta": {},
"icons": [
{}
],
"annotations": {},
"execution": {
"taskSupport": "forbidden"
}
}
],
"removed": [
{
"name": "<string>",
"title": "<string>",
"description": "<string>",
"inputSchema": "<unknown>",
"outputSchema": "<unknown>",
"meta": {},
"icons": [
{}
],
"annotations": {},
"execution": {
"taskSupport": "forbidden"
}
}
],
"changed": [
{
"name": "<string>",
"changedFields": [
"<string>"
],
"before": {
"name": "<string>",
"title": "<string>",
"description": "<string>",
"inputSchema": "<unknown>",
"outputSchema": "<unknown>",
"meta": {},
"icons": [
{}
],
"annotations": {},
"execution": {
"taskSupport": "forbidden"
}
},
"after": {
"name": "<string>",
"title": "<string>",
"description": "<string>",
"inputSchema": "<unknown>",
"outputSchema": "<unknown>",
"meta": {},
"icons": [
{}
],
"annotations": {},
"execution": {
"taskSupport": "forbidden"
}
}
}
]
},
"discovery": [
{
"field": "<string>",
"before": "<unknown>",
"after": "<unknown>"
}
],
"droppedFields": {
"from": [
"<string>"
],
"to": [
"<string>"
]
}
}
Authorizations
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
ID of the hosted project that contains the server.
ID of the server inside the project.
The revision, as numbered by the revision list.
Required range:
x >= 1Query Parameters
The revision to compare against. Defaults to revisionNumber - 1.
Required range:
x >= 1Response
The differences between the two revisions.
Was this page helpful?
⌘I
Diff two server revisions
curl --request GET \
--url https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/revisions/{revisionNumber}/diff \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/revisions/{revisionNumber}/diff"
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}/servers/{serverId}/revisions/{revisionNumber}/diff', 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}/servers/{serverId}/revisions/{revisionNumber}/diff",
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}/servers/{serverId}/revisions/{revisionNumber}/diff"
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}/servers/{serverId}/revisions/{revisionNumber}/diff")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/revisions/{revisionNumber}/diff")
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{
"from": {
"revisionNumber": 2,
"capturedAt": 123,
"source": "connect",
"sourceId": "<string>",
"counts": {
"tools": 123,
"prompts": 123,
"resources": 123,
"resourceTemplates": 123
}
},
"to": {
"revisionNumber": 2,
"capturedAt": 123,
"source": "connect",
"sourceId": "<string>",
"counts": {
"tools": 123,
"prompts": 123,
"resources": 123,
"resourceTemplates": 123
}
},
"tools": {
"added": [
{
"name": "<string>",
"title": "<string>",
"description": "<string>",
"inputSchema": "<unknown>",
"outputSchema": "<unknown>",
"meta": {},
"icons": [
{}
],
"annotations": {},
"execution": {
"taskSupport": "forbidden"
}
}
],
"removed": [
{
"name": "<string>",
"title": "<string>",
"description": "<string>",
"inputSchema": "<unknown>",
"outputSchema": "<unknown>",
"meta": {},
"icons": [
{}
],
"annotations": {},
"execution": {
"taskSupport": "forbidden"
}
}
],
"changed": [
{
"name": "<string>",
"changedFields": [
"<string>"
],
"before": {
"name": "<string>",
"title": "<string>",
"description": "<string>",
"inputSchema": "<unknown>",
"outputSchema": "<unknown>",
"meta": {},
"icons": [
{}
],
"annotations": {},
"execution": {
"taskSupport": "forbidden"
}
},
"after": {
"name": "<string>",
"title": "<string>",
"description": "<string>",
"inputSchema": "<unknown>",
"outputSchema": "<unknown>",
"meta": {},
"icons": [
{}
],
"annotations": {},
"execution": {
"taskSupport": "forbidden"
}
}
}
]
},
"discovery": [
{
"field": "<string>",
"before": "<unknown>",
"after": "<unknown>"
}
],
"droppedFields": {
"from": [
"<string>"
],
"to": [
"<string>"
]
}
}