MCP Publishing

naftiko: 1.0.0-alpha2
info:
  label: MCP Publishing
  description: >-
    Capability that publishes the Jentic catalog as Model Context Protocol
    tools — both via Jentic's hosted Remote MCP server at
    https://api.jentic.com/mcp and via a self-hosted local MCP server. It
    standardizes the tool surface so the same agent skills work in Claude
    Desktop, ChatGPT, Cursor, Windsurf, and VS Code without per-client
    glue. Supports OAuth 2.0 with PKCE and dynamic client registration,
    plus API-key fallback.
  tags:
    - MCP
    - Model Context Protocol
    - Remote MCP
    - Local MCP
    - Jentic
  created: '2026-05-15'
  modified: '2026-05-15'
capability:
  consumes:
    - type: http
      namespace: jentic-mcp
      baseUri: https://api.jentic.com/mcp
      description: Hosted Jentic Remote MCP endpoint.
      authentication:
        type: oauth2
        notes: >-
          OAuth 2.0 with PKCE and dynamic client registration recommended.
          API key fallback (`X-JENTIC-API-KEY`) supported for Cursor and
          Windsurf.
  exposes:
    - type: mcp
      port: 9090
      namespace: jentic-published-mcp
      transport: http
      description: >-
        Publishes the canonical Jentic agent toolset as MCP tools and
        resources. Mirrors api.jentic.com/mcp.
      tools:
        - name: search_apis
          description: Type what you need; MCP lists matching APIs and workflows.
          hints:
            readOnly: true
            destructive: false
            idempotent: true
        - name: load_execution_info
          description: Details on an operation's inputs and auth requirements.
          hints:
            readOnly: true
            destructive: false
            idempotent: true
        - name: execute
          description: Run an API operation with managed credentials.
          hints:
            readOnly: false
            destructive: true
            idempotent: false
      resources:
        - name: list_credentials
          description: List the agent's available upstream credentials.
    - type: mcp
      port: 9091
      namespace: jentic-local-mcp
      transport: stdio
      description: Local self-hosted MCP server (Jentic Mini, jentic-sdks).
      tools:
        - name: search_apis
        - name: load_execution_info
        - name: execute
clients:
  - name: Claude Desktop
    auth: oauth
  - name: ChatGPT
    auth: oauth
  - name: Cursor
    auth: oauth | apikey
  - name: Windsurf
    auth: oauth | apikey
  - name: VS Code
    auth: local
binds:
  - namespace: env
    keys:
      JENTIC_AGENT_API_KEY: JENTIC_AGENT_API_KEY