Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

GraphQL API (ReasonKit MCP (Pro))

ReasonKit MCP (Pro) provides a flexible GraphQL endpoint for complex data fetching and real-time reasoning trace subscriptions.

Endpoint

https://api.reasonkit.sh/v1/graphql


Schema Overview

Queries

thinkingChain(id: ID!): ReasoningChain

Retrieve a specific reasoning chain by its unique ID.

profiles: [Profile!]!

List all available reasoning profiles.

Mutations

executeReasoning(input: ThinkInput!): ReasoningChain!

Trigger a new reasoning session.


Types

ReasoningChain

FieldTypeDescription
idID!Unique session identifier.
timestampString!Start time (ISO8601).
statusChainStatus!PENDING, RUNNING, COMPLETED, FAILED.
resultStringThe final synthesized answer.
steps[ReasoningStep!]!The list of discrete reasoning steps.
metricsMetrics!Usage and performance data.

ReasoningStep

FieldTypeDescription
stepIdInt!Sequence number.
moduleString!ThinkTool module name.
phaseString!Internal phase identifier.
contentString!The reasoning content.
confidenceFloat0.0 - 1.0 certainty score.

Example Query

query GetChainDetails($id: ID!) {
  thinkingChain(id: $id) {
    status
    result
    steps {
      stepId
      module
      content
      confidence
    }
    metrics {
      totalDurationMs
      totalTokens
    }
  }
}

Subscriptions (Real-time)

ReasonKit MCP (Pro) supports GraphQL Subscriptions over WebSockets for live reasoning traces.

subscription OnStepGenerated($chainId: ID!) {
  stepGenerated(chainId: $chainId) {
    stepId
    module
    content
  }
}