Read a server skill's supporting file

POST

projects

{projectId}

servers

{serverId}

skills

read-file

Read a server skill's supporting file

curl --request POST \
  --url https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skillUri": "skill://acme/refunds/SKILL.md",
  "resourceUri": "skill://acme/refunds/scripts/run.py"
}
'

import requests

url = "https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file"

payload = {
    "skillUri": "skill://acme/refunds/SKILL.md",
    "resourceUri": "skill://acme/refunds/scripts/run.py"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    skillUri: 'skill://acme/refunds/SKILL.md',
    resourceUri: 'skill://acme/refunds/scripts/run.py'
  })
};

fetch('https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file', 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}/skills/read-file",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'skillUri' => 'skill://acme/refunds/SKILL.md',
    'resourceUri' => 'skill://acme/refunds/scripts/run.py'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file"

	payload := strings.NewReader("{\n  \"skillUri\": \"skill://acme/refunds/SKILL.md\",\n  \"resourceUri\": \"skill://acme/refunds/scripts/run.py\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"skillUri\": \"skill://acme/refunds/SKILL.md\",\n  \"resourceUri\": \"skill://acme/refunds/scripts/run.py\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"skillUri\": \"skill://acme/refunds/SKILL.md\",\n  \"resourceUri\": \"skill://acme/refunds/scripts/run.py\"\n}"

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

{
  "support": {
    "declared": true,
    "advertised": true,
    "directoryRead": true,
    "active": true
  },
  "file": {
    "uri": "<string>",
    "text": "<string>",
    "digest": "<string>"
  },
  "refusal": {
    "kind": "no_resources",
    "message": "<string>",
    "skillUri": "<string>",
    "resourceUri": "<string>",
    "expected": "<string>",
    "actual": "<string>",
    "field": "<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.

serverId

string

required

ID of the server inside the project.

Body

application/json

skillUri

string

required

The owning skill's URI.

Example:

"skill://acme/refunds/SKILL.md"

resourceUri

string

required

The file's URI, which must appear in that skill's manifest.

Example:

"skill://acme/refunds/scripts/run.py"

Response

The verified file, or the refusal that stopped it.

Option 1
Option 2

Either the verified file contents, or the refusal that stopped it.

support

object

required

Mutual-declaration state of the skills extension on this connection. active false means the extension was never negotiated — a capability state, not a failure.

Show child attributes

file

object

required

Show child attributes

refusal

object

Why MCPJam declined to load a skill or file. A refusal is a RESULT, not an error: the request succeeded, and this names the specific check that failed so a server author can act on it.

Show child attributes

⌘I

Read a server skill's supporting file

curl --request POST \
  --url https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skillUri": "skill://acme/refunds/SKILL.md",
  "resourceUri": "skill://acme/refunds/scripts/run.py"
}
'

import requests

url = "https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file"

payload = {
    "skillUri": "skill://acme/refunds/SKILL.md",
    "resourceUri": "skill://acme/refunds/scripts/run.py"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    skillUri: 'skill://acme/refunds/SKILL.md',
    resourceUri: 'skill://acme/refunds/scripts/run.py'
  })
};

fetch('https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file', 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}/skills/read-file",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'skillUri' => 'skill://acme/refunds/SKILL.md',
    'resourceUri' => 'skill://acme/refunds/scripts/run.py'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file"

	payload := strings.NewReader("{\n  \"skillUri\": \"skill://acme/refunds/SKILL.md\",\n  \"resourceUri\": \"skill://acme/refunds/scripts/run.py\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"skillUri\": \"skill://acme/refunds/SKILL.md\",\n  \"resourceUri\": \"skill://acme/refunds/scripts/run.py\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/skills/read-file")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"skillUri\": \"skill://acme/refunds/SKILL.md\",\n  \"resourceUri\": \"skill://acme/refunds/scripts/run.py\"\n}"

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

{
  "support": {
    "declared": true,
    "advertised": true,
    "directoryRead": true,
    "active": true
  },
  "file": {
    "uri": "<string>",
    "text": "<string>",
    "digest": "<string>"
  },
  "refusal": {
    "kind": "no_resources",
    "message": "<string>",
    "skillUri": "<string>",
    "resourceUri": "<string>",
    "expected": "<string>",
    "actual": "<string>",
    "field": "<string>"
  }
}

API Guides

Endpoints

Read a server skill's supporting file

Authorizations

Path Parameters

Body

Response