Skip to main content
POST
Get a server skill

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
uri
string
required

The skill URI, as returned by the skills list.

Example:

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

Response

The verified skill, or the refusal that stopped it.

Either the verified skill, or the refusal that stopped it. Never both.

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.

skill
object
required

A skill whose SKILL.md was fetched and checked against its manifest digest, its advertised frontmatter, and its URI identity before any byte was returned.

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.