sight/api/openapi.yaml at b4c1874922b7fe7ad037f9a79f4dc2dd92ea55a7 · GrayCodeAI/sight · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
openapi: "3.1.0"
info:
  title: sight — Code Review Tool Reference
  description: |
    sight is an AI-powered code review library for diffs.
    It parses unified diffs, enriches with code context and git history,
    and runs parallel multi-concern reviews through an LLM provider.

    sight operates as a Go library and MCP server (stdio or HTTP).
    This document describes the MCP tool surface as a machine-readable reference.
  version: "0.1.0"
  license:
    name: MIT
    url: https://github.com/GrayCodeAI/sight/blob/main/LICENSE
  contact:
    url: https://github.com/GrayCodeAI/sight

# sight ships no standalone binary. The MCP server is embedded by the host
# program (e.g. hawk), which injects a Provider and starts a transport:
#   srv := mcp.New(provider, opts...)
#   srv.ServeStdio()                 // stdio transport (default)
#   srv.ServeHTTP("127.0.0.1:8080")  // streamable HTTP transport, served at /mcp

tags:
  - name: review
    description: Code review tools
  - name: taint
    description: Security taint analysis

x-mcp-server:
  transport: stdio
  package: github.com/GrayCodeAI/sight/mcp
  constructor: mcp.New(provider, opts...)
  serve_stdio: mcp.Server.ServeStdio()
  serve_http: mcp.Server.ServeHTTP("127.0.0.1:8080")  # served at /mcp

x-mcp-tools:
  sight_review:
    description: AI code review on a unified diff — security, correctness, style, performance
    inputSchema:
      type: object
      required: [diff]
      properties:
        diff:
          type: string
          description: Unified diff text (output of `git diff`)
        preset:
          type: string
          enum: [Quick, Standard, Thorough, SecurityFocus, CI]
          default: Standard
          description: Review thoroughness preset
        exclude_files:
          type: array
          items:
            type: string
          description: File patterns to exclude from review (glob)
        max_tokens:
          type: integer
          description: Maximum tokens for the LLM review

  sight_describe:
    description: Generate a pull request description from a unified diff
    inputSchema:
      type: object
      required: [diff]
      properties:
        diff:
          type: string
          description: Unified diff text

  sight_improve:
    description: Suggest specific code improvements for a diff
    inputSchema:
      type: object
      required: [diff]
      properties:
        diff:
          type: string
        focus:
          type: string
          description: Focus area for improvements (e.g. "performance", "readability")

  sight_taint:
    description: SSA-based cross-function taint analysis for security vulnerabilities
    inputSchema:
      type: object
      required: [path]
      properties:
        path:
          type: string
          description: Absolute path to the Go package or module root
        patterns:
          type: string
          default: "./..."
          description: Go package patterns to analyze
        json:
          type: boolean
          default: false
          description: Output results as JSON