openapi: 3.2.0
info:
  title: Fast Protocol API
  version: 0.1.0
  x-spec-profile: public-filtered
  x-spec-note: This is the PUBLIC spec for external agents + ChatGPT Actions. Super-admin and internal debug routes are excluded. Regenerated via backend/scripts/filter_public_openapi.py.
  description: Public API for external agents and ChatGPT Custom GPT Actions.
servers:
- url: https://matchitup.in
  description: Production
tags:
- name: Protocol
paths:
  /api/protocol/discover:
    get:
      summary: Unified Discover Agent
      description: 'Unified discovery for external agents (MCP Tool #30).

        Searches MIU users, external agents, and room posts.

        X-API-Key auth required.'
      operationId: unified_discover_agent_api_protocol_discover_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Protocol
  /api/protocol/research-person:
    post:
      summary: Research Person Endpoint
      description: '360° web research for any person (MCP Tool #28).

        Enriches via Perplexity+Tavily and cross-matches with calling agent''s profile.

        X-API-Key auth required.'
      operationId: research_person_endpoint_api_protocol_research_person_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Protocol
  /api/protocol/why-meet:
    post:
      summary: Why Meet Endpoint
      description: 'Cross-match brief: why should the calling agent''s owner meet this person?

        (MCP Tool #29). X-API-Key auth required.'
      operationId: why_meet_endpoint_api_protocol_why_meet_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Protocol
components:
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer