intencheck-com MCP API

openapi: 3.2.0
info:
  title: IntenCheck MCP API
  description: 'IntenCheck provides a comprehensive suite of Deep NLP text analysis endpoints that detect meta-programs, emotions, moods, and communication styles.

    It supports multiple input and output languages natively.


    ## Quick Start


    1. **Get your API Key** from the developer dashboard.

    2. **Analyze Text** to get a psychological profile.

    3. **Generate a Reply** using the analysis context to match or adjust styles.


    ## Authentication

    All non-demo API endpoints require authentication via an API key. Pass it in your headers:

    - `X-API-Key: YOUR_KEY`

    - `Authorization: Bearer YOUR_KEY`


    ## Code Examples


    **1. Analyze Text (Python / cURL)**


    ```bash

    curl -X ''POST'' \

    ''https://intencheck.com/api/v1/analyze'' \

    -H ''accept: application/json'' \

    -H ''Authorization: Bearer YOUR_API_KEY'' \

    -H ''Content-Type: application/json'' \

    -d ''{

    "text": "I am so frustrated that you never listen to my feedback!",

    "features": ["emotions", "communication_style"],

    "output_lang": "en"

    }''

    ```


    **2. Generate a Reply**


    ```bash

    curl -X ''POST'' \

    ''https://intencheck.com/api/v1/reply'' \

    -H ''accept: application/json'' \

    -H ''Authorization: Bearer YOUR_API_KEY'' \

    -H ''Content-Type: application/json'' \

    -d ''{

    "original_text": "I am so frustrated that you never listen to my feedback!",

    "analysis_data": { ... result from /analyze ... },

    "strategy": "de_escalate",

    "mode": "constructive"

    }''

    ```


    ## Common Error Codes

    | Status | Description |

    |--------|-------------|

    | `400` | Bad Request: Invalid parameters or JSON schema. |

    | `401` | Unauthorized: Missing or invalid API Key. |

    | `402` | Payment Required: Insufficient prepaid balance. |

    | `429` | Too Many Requests: Rate limit exceeded. |

    | `500` | Internal Server Error / Upstream AI failure. |'
  contact:
    name: IntenCheck Developer Support
    url: https://intencheck.com/
  version: 1.1.0
tags:
- name: MCP
paths:
  /api/v1/mcp/status:
    get:
      summary: Check authenticated IntenCheck MCP readiness
      description: Return a lightweight authenticated readiness response for MCP clients. Use this tool before paid analysis calls to verify that authentication, routing, and the IntenCheck MCP runtime are usable. This endpoint does not call the LLM provider and does not consume word balance.
      operationId: mcp_status
      security:
      - OAuth2PasswordBearer: []
      parameters:
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: access_token
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Access Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - MCP
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    McpStatusResponse:
      properties:
        status:
          type: string
          const: ok
          title: Status
          description: Operational MCP status.
        service:
          type: string
          title: Service
          description: Human-readable service name.
        authenticated:
          type: boolean
          title: Authenticated
          description: Whether the request passed IntenCheck authentication.
        account_id:
          type: integer
          title: Account Id
          description: Authenticated IntenCheck account ID.
        mcp_endpoint:
          type: string
          title: Mcp Endpoint
          description: Public MCP endpoint clients should use.
        docs_url:
          type: string
          title: Docs Url
          description: Public MCP integration documentation URL.
        checked_at:
          type: string
          format: date-time
          title: Checked At
          description: UTC timestamp when this status response was produced.
      type: object
      required:
      - status
      - service
      - authenticated
      - account_id
      - mcp_endpoint
      - docs_url
      - checked_at
      title: McpStatusResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: /api/v1/auth/login