Get my context

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://api-docs.kitsu.cloud/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Kitsu API MCP server": {
    "url": "https://api-docs.kitsu.cloud/mcp"
  }
}

GET /data/user/context

Jwt authorization

Get the data that an application needs to start. projects are your open projects, or all the open projects for an administrator. persons depends on your role. A client gets only the members of the teams of their open projects, with a reduced set of fields. A manager or an administrator gets all the persons with all their fields. Another role gets all the persons with a minimal set of fields. An administrator also gets user_limit. Each project gives asset_type_workflows, the task type ids of the workflows it sets, by asset type id.

Responses

200 application/json

The context
Hide response attributes Show response attributes object
- projects array[object]
  
  Available projects
- departments array[object]
  
  Available departments
- asset_types array[object]
  
  Available asset types
- task_types array[object]
  
  Available task types
- task_status array[object]
  
  Available task statuses
- custom_actions array[object]
  
  Available custom actions
- status_automations array[object]
  
  Available status automations
- studios array[object]
  
  Available studios
- notification_count integer
  
  Number of unread notifications
- persons array[object]
  
  Available persons
- project_status array[object]
  
  Available project statuses
- search_filters object
  
  Your filters by list type and by project, as in the filters route
- search_filter_groups object
  
  Your filter groups by list type and by project, as in the filter groups route
- preview_background_files array[object]
  
  Available preview background files
- project_roles object
  
  The role you hold on each project where your team link sets one, by project identifier
  
  Hide project_roles attribute Show project_roles attribute object
  
  * string Additional properties
- plugins array[object]
  
  Installed plugins
- user_limit integer
  
  Maximum number of active users, for an administrator only
403

You use a bot token

GET /data/user/context

curl -X GET "http://api.example.com/data/user/context" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

import requests

url = "http://api.example.com/data/user/context"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
params = {}
payload = None

response = requests.get(
    url,
    headers=headers,
    params=params,
    json=payload
)

response.raise_for_status()

if response.content:
    print(response.json())

Response examples (200)

{
  "projects": [
    {
      "id": "uuid",
      "name": "Project 1"
    }
  ],
  "departments": [
    {
      "id": "uuid",
      "name": "Animation"
    }
  ],
  "asset_types": [
    {
      "id": "uuid",
      "name": "Character"
    }
  ],
  "task_types": [
    {
      "id": "uuid",
      "name": "Modeling"
    }
  ],
  "task_status": [
    {
      "id": "uuid",
      "name": "In Progress"
    }
  ],
  "custom_actions": [
    {
      "id": "uuid",
      "name": "Custom Action"
    }
  ],
  "status_automations": [
    {
      "id": "uuid",
      "name": "Auto Status"
    }
  ],
  "studios": [
    {
      "id": "uuid",
      "name": "Studio Name"
    }
  ],
  "notification_count": 5,
  "persons": [
    {
      "id": "uuid",
      "name": "John Doe"
    }
  ],
  "project_status": [
    {
      "id": "uuid",
      "name": "Active"
    }
  ],
  "search_filters": {
    "todo": {
      "all": [
        {
          "id": "uuid",
          "name": "My Filter"
        }
      ]
    }
  },
  "search_filter_groups": {
    "todo": {
      "all": [
        {
          "id": "uuid",
          "name": "Filter Group"
        }
      ]
    }
  },
  "preview_background_files": [
    {
      "id": "uuid",
      "name": "background.jpg"
    }
  ],
  "project_roles": {
    "a24a6ea4-ce75-4665-a070-57453082c250": "supervisor"
  },
  "plugins": [
    {}
  ],
  "user_limit": 50
}