Skip to main content

Tydli Platform API Reference

The Tydli Platform API allows you to manage your deployments and OAuth clients programmatically.

Base URL

All API requests should be made to:

Authentication

Most endpoints require authentication. You can authenticate using:
  • Bearer Token: Authorization: Bearer <your-jwt-token>

OAuth 2.1 Server

Endpoints for managing OAuth clients and performing OAuth flows.

Register Client

Register a new OAuth client for your deployment.
  • Endpoint: POST /mcp-oauth-server/register
  • Content-Type: application/json
Request Body:
Response:

Authorization Endpoint

The URL to redirect users to for authorization.
  • URL: GET /mcp-oauth-server/authorize
  • Parameters:
    • INLINE_CODE_4: Your client ID
    • INLINE_CODE_5: INLINE_CODE_6
    • INLINE_CODE_7: One of your registered redirect URIs
    • INLINE_CODE_8: PKCE code challenge
    • INLINE_CODE_9: INLINE_CODE_10
    • INLINE_CODE_11: Random string for CSRF protection

Token Endpoint

Exchange an authorization code for an access token.
  • URL: POST /mcp-oauth-server/token
  • Content-Type: application/json
Request Body:

MCP Router

Endpoints for interacting with your deployed MCP servers.

Invoke Tool

Call a tool on your deployed MCP server.
  • Endpoint: POST /mcp-router/{deployment_slug}/messages
  • Headers:
    • INLINE_CODE_15: INLINE_CODE_16
Request Body:

List Resources

List all resources defined for a deployment.
  • Endpoint: POST /mcp-router/{deployment_slug}/messages
Request Body:
Response:

Read Resource

Read content of a specific resource by URI.
  • Endpoint: POST /mcp-router/{deployment_slug}/messages
Request Body:
Response:

List Prompts

List all prompts defined for a deployment.
  • Endpoint: POST /mcp-router/{deployment_slug}/messages
Request Body:
Response:

Get Prompt

Get a specific prompt and render its template with arguments.
  • Endpoint: POST /mcp-router/{deployment_slug}/messages
Request Body:
Response:

Discovery

Protected Resource Metadata

Discover OAuth configuration for a resource.
  • Endpoint: GET /mcp-router/{deployment_slug}/.well-known/oauth-protected-resource
Response: