Toolhouse Mcp Discovery Register

naftiko: "1.0.0-alpha2"

info:
  title: Toolhouse MCP Discovery Register
  description: >-
    Registers Naftiko-built MCP servers with Toolhouse's MCP Discovery
    registry so any Toolhouse agent that requires that capability can
    auto-detect and wire the Naftiko-built MCP at agent-deploy time.
    Lets a Naftiko-built capability become invocable by any Toolhouse
    agent through Toolhouse's prompt-driven MCP wiring.
  tags:
    - Naftiko
    - Toolhouse
    - Partnership
    - MCP
    - Discovery
    - Auto-Wiring
  created: '2026-05-15'
  modified: '2026-05-15'

binds:
  - namespace: toolhouse-env
    description: Toolhouse Platform API key.
    keys:
      TOOLHOUSE_API_KEY: TOOLHOUSE_API_KEY

capability:
  consumes:
    - namespace: toolhouse
      type: http
      baseUri: https://api.toolhouse.ai
      authentication:
        type: bearer
        token: '{{TOOLHOUSE_API_KEY}}'
      resources:
        - name: list-mcp-registry-servers
          path: '/me/mcp-registry/servers'
          operations:
            - name: list-mcp-registry-servers
              method: GET
              inputParameters:
                - { name: visibility, in: query, type: string, required: false }
            - name: register-mcp-registry-server
              method: POST
        - name: mcp-registry-server
          path: '/me/mcp-registry/servers/{{registry_id}}'
          operations:
            - name: get-mcp-registry-server
              method: GET
              inputParameters:
                - { name: registry_id, in: path, required: true }
            - name: update-mcp-registry-server
              method: PUT
              inputParameters:
                - { name: registry_id, in: path, required: true }
            - name: delete-mcp-registry-server
              method: DELETE
              inputParameters:
                - { name: registry_id, in: path, required: true }

  exposes:
    - type: rest
      address: 0.0.0.0
      port: 8080
      namespace: toolhouse-mcp-discovery-register-rest
      description: REST surface for managing Toolhouse MCP Discovery registry entries.
      resources:
        - name: mcp-registry
          path: '/mcp-registry'
          operations:
            - name: list-mcp-registry-servers
              method: GET
              inputParameters:
                - { name: visibility, in: query, type: string, required: false }
              call: toolhouse.list-mcp-registry-servers
            - name: register-mcp-registry-server
              method: POST
              call: toolhouse.register-mcp-registry-server
        - name: mcp-registry-server
          path: '/mcp-registry/{registry_id}'
          operations:
            - name: get-mcp-registry-server
              method: GET
              inputParameters:
                - { name: registry_id, in: path, type: string, required: true }
              call: toolhouse.get-mcp-registry-server
            - name: update-mcp-registry-server
              method: PUT
              inputParameters:
                - { name: registry_id, in: path, type: string, required: true }
              call: toolhouse.update-mcp-registry-server
            - name: delete-mcp-registry-server
              method: DELETE
              inputParameters:
                - { name: registry_id, in: path, type: string, required: true }
              call: toolhouse.delete-mcp-registry-server

    - type: mcp
      address: 0.0.0.0
      port: 3010
      namespace: toolhouse-mcp-discovery-register-mcp
      description: MCP server for managing Toolhouse MCP Discovery registrations.
      tools:
        - name: list-mcp-registry-servers
          description: List MCP servers registered with Toolhouse's MCP Discovery registry.
          hints: { readOnly: true }
          inputParameters:
            - { name: visibility, type: string, required: false, description: Filter by visibility (public / private). }
          call: toolhouse.list-mcp-registry-servers
        - name: register-mcp-registry-server
          description: Register a Naftiko-built MCP server with Toolhouse MCP Discovery so agents auto-wire it.
          hints: { destructiveHint: false }
          call: toolhouse.register-mcp-registry-server
        - name: get-mcp-registry-server
          description: Get a single Toolhouse MCP Discovery registry entry.
          hints: { readOnly: true }
          inputParameters:
            - { name: registry_id, type: string, required: true, description: Toolhouse MCP registry entry ID. }
          call: toolhouse.get-mcp-registry-server
        - name: update-mcp-registry-server
          description: Update a Toolhouse MCP Discovery registry entry.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: registry_id, type: string, required: true, description: Toolhouse MCP registry entry ID. }
          call: toolhouse.update-mcp-registry-server
        - name: delete-mcp-registry-server
          description: Delete a Toolhouse MCP Discovery registry entry.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: registry_id, type: string, required: true, description: Toolhouse MCP registry entry ID. }
          call: toolhouse.delete-mcp-registry-server