---
title: "Get skill MCP availability"
method: GET
path: "/skills/{skill_id}/mcp-availability"
tags: ["Skill Files"]
---

# Get skill MCP availability

`GET /skills/{skill_id}/mcp-availability`

## Request

- Base URL: `https://api.metorial.com`
- URL: `https://api.metorial.com/skills/{skill_id}/mcp-availability`
- Auth: HTTP bearer

Returns whether apps connected over MCP can see the skill. Skills with too many files or too large a total size are left out of MCP connections and keep working everywhere else.

## Path parameters

- `skill_id` string, required

## Headers

- `Metorial-Version` string

## Response `200`

Successful response

- SkillMcpAvailability
  - `object` 'skill.mcp_availability', required: String representing the object's type
  - `skill_id` string, required: The ID of the skill.
  - `available` boolean, required: Whether apps connected over MCP can see the skill. Skills over a limit are left out of MCP connections but keep working everywhere else.
  - `exceeded_limits` string[], required: The limits the skill is over. Empty when the skill is available.
  - `file_count` number, required: Number of files the skill would share over MCP.
  - `size` number, required: Total size in bytes of the files the skill would share over MCP.
  - `max_file_count` number, required: Most files a skill can have and still be shared over MCP.
  - `max_size` number, required: Largest total size in bytes a skill can have and still be shared over MCP.

## Other responses

- `400`: Invalid parameters or action
- `401`: Missing or invalid API key
- `403`: The key lacks permission for this resource
- `404`: No such resource
- `422`: Validation failed
- `429`: Rate limit exceeded
- `500`: Unexpected server error

---

[API](https://skmtc.dev/metorial/apis/metorial-api.md) - [All operations](https://skmtc.dev/metorial/apis/metorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metorial/apis/metorial-api/revisions/10ccc89f3eac?raw)