Refresh the access token

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

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

Close
GET /auth/refresh-token

Get a new access token. Send the refresh token as the bearer token. An access token expires after a period. Use this route before the access token expires. A browser gets the new token in a cookie.

Responses

  • 200 application/json

    The new access token, or a refresh flag for a browser

    Hide response attributes Show response attributes object
    • access_token string
    • refresh boolean
  • 403

    The token belongs to a bot

GET /auth/refresh-token
curl -X GET "http://api.example.com/auth/refresh-token" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
import requests

url = "http://api.example.com/auth/refresh-token"
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)
{
  "access_token": "string",
  "refresh": true
}