{"openapi":"3.1.0","info":{"title":"DeepSource (BYOK) API","version":"0.1.0","description":"DeepSource (BYOK) lets an AI assistant read your own DeepSource data through the DeepSource API with a key you supply (DeepSource personal access token). Read-only: 11 tools (get_viewer, list_analyzers, get_account, list_account_repositories, get_repository, list_analysis_runs, get_analysis_run, list_pull_requests, list_repository_issues, list_dependency_vulnerabilities, get_repository_metrics)....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-deepsource.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-deepsource/docs"},"termsOfService":"https://connectorbay.com/byok-deepsource/terms"},"servers":[{"url":"https://byok-deepsource.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-deepsource/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_viewer":{"post":{"operationId":"get_viewer","summary":"Show the DeepSource user the token belongs to with the accounts (teams and personal) they can access. Use for \"Which Dee","description":"Show the DeepSource user the token belongs to with the accounts (teams and personal) they can access. Use for \"Which DeepSource user and accounts is my token connected to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_viewerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_analyzers":{"post":{"operationId":"list_analyzers","summary":"List the analyzers (languages and tools) DeepSource offers, with shortcode, name and type. Use for \"Which analyzers does","description":"List the analyzers (languages and tools) DeepSource offers, with shortcode, name and type. Use for \"Which analyzers does DeepSource support\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items to return (1 to 100).","title":"First"},"after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous page's pageInfo.endCursor to continue after; leave empty for the first page.","title":"After"}},"title":"list_analyzersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_account":{"post":{"operationId":"get_account","summary":"Get one DeepSource account (team or individual) by login: type, source host, profile link and avatar. Use for \"What kind","description":"Get one DeepSource account (team or individual) by login: type, source host, profile link and avatar. Use for \"What kind of DeepSource account is cyberdyne\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"login":{"description":"Login (username or organization name) of the DeepSource account, for example 'cyberdyne'.","maxLength":100,"title":"Login","type":"string"},"vcs_provider":{"description":"Source host of the account: GITHUB, GITHUB_ENTERPRISE, GITLAB, BITBUCKET, BITBUCKET_DATACENTER or ADS (Azure DevOps Services).","enum":["GITHUB","GITHUB_ENTERPRISE","GITLAB","BITBUCKET","BITBUCKET_DATACENTER","ADS"],"title":"Vcs Provider","type":"string"}},"required":["login","vcs_provider"],"title":"get_accountArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_account_repositories":{"post":{"operationId":"list_account_repositories","summary":"List the repositories of a DeepSource account with visibility, activation state, default branch and latest commit. Curso","description":"List the repositories of a DeepSource account with visibility, activation state, default branch and latest commit. Cursor paginated. Use for \"Which repositories does cyberdyne have on DeepSource and which are activated\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"login":{"description":"Login (username or organization name) of the DeepSource account, for example 'cyberdyne'.","maxLength":100,"title":"Login","type":"string"},"vcs_provider":{"description":"Source host of the account: GITHUB, GITHUB_ENTERPRISE, GITLAB, BITBUCKET, BITBUCKET_DATACENTER or ADS (Azure DevOps Services).","enum":["GITHUB","GITHUB_ENTERPRISE","GITLAB","BITBUCKET","BITBUCKET_DATACENTER","ADS"],"title":"Vcs Provider","type":"string"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items to return (1 to 100).","title":"First"},"after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous page's pageInfo.endCursor to continue after; leave empty for the first page.","title":"After"}},"required":["login","vcs_provider"],"title":"list_account_repositoriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_repository":{"post":{"operationId":"get_repository","summary":"Get one DeepSource repository: visibility, activation, default branch, latest commit and the analyzers enabled on it. Us","description":"Get one DeepSource repository: visibility, activation, default branch, latest commit and the analyzers enabled on it. Use for \"Is demo-go activated on DeepSource and which analyzers does it use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Repository name without the owner, for example 'demo-go'.","maxLength":100,"title":"Name","type":"string"},"login":{"description":"Login (username or organization name) of the DeepSource account, for example 'cyberdyne'.","maxLength":100,"title":"Login","type":"string"},"vcs_provider":{"description":"Source host of the account: GITHUB, GITHUB_ENTERPRISE, GITLAB, BITBUCKET, BITBUCKET_DATACENTER or ADS (Azure DevOps Services).","enum":["GITHUB","GITHUB_ENTERPRISE","GITLAB","BITBUCKET","BITBUCKET_DATACENTER","ADS"],"title":"Vcs Provider","type":"string"}},"required":["name","login","vcs_provider"],"title":"get_repositoryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_analysis_runs":{"post":{"operationId":"list_analysis_runs","summary":"List recent analysis runs of a repository, optionally for one branch, with status, commit and counts of issues introduce","description":"List recent analysis runs of a repository, optionally for one branch, with status, commit and counts of issues introduced, resolved and suppressed. Use for \"Did the last DeepSource analysis of demo-go on main find new issues\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Repository name without the owner, for example 'demo-go'.","maxLength":100,"title":"Name","type":"string"},"login":{"description":"Login (username or organization name) of the DeepSource account, for example 'cyberdyne'.","maxLength":100,"title":"Login","type":"string"},"vcs_provider":{"description":"Source host of the account: GITHUB, GITHUB_ENTERPRISE, GITLAB, BITBUCKET, BITBUCKET_DATACENTER or ADS (Azure DevOps Services).","enum":["GITHUB","GITHUB_ENTERPRISE","GITLAB","BITBUCKET","BITBUCKET_DATACENTER","ADS"],"title":"Vcs Provider","type":"string"},"branch":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only runs on this branch.","title":"Branch"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items to return (1 to 100).","title":"First"},"after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous page's pageInfo.endCursor to continue after; leave empty for the first page.","title":"After"}},"required":["name","login","vcs_provider"],"title":"list_analysis_runsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_analysis_run":{"post":{"operationId":"get_analysis_run","summary":"Get one analysis run by its UID: status, branch, commit, issue counts and the report card with grades for security, reli","description":"Get one analysis run by its UID: status, branch, commit, issue counts and the report card with grades for security, reliability, complexity, hygiene and coverage. Use for \"What grades did DeepSource give analysis run 5d821174-0000-4000-8000-000000000001\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"run_uid":{"description":"UID of the analysis run (a UUID from list_analysis_runs).","maxLength":64,"title":"Run Uid","type":"string"}},"required":["run_uid"],"title":"get_analysis_runArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_pull_requests":{"post":{"operationId":"list_pull_requests","summary":"List pull requests DeepSource has analyzed in a repository, optionally for one branch, with state and counts of issues a","description":"List pull requests DeepSource has analyzed in a repository, optionally for one branch, with state and counts of issues and vulnerabilities raised or resolved. Use for \"Which pull requests of demo-go have DeepSource issues\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Repository name without the owner, for example 'demo-go'.","maxLength":100,"title":"Name","type":"string"},"login":{"description":"Login (username or organization name) of the DeepSource account, for example 'cyberdyne'.","maxLength":100,"title":"Login","type":"string"},"vcs_provider":{"description":"Source host of the account: GITHUB, GITHUB_ENTERPRISE, GITLAB, BITBUCKET, BITBUCKET_DATACENTER or ADS (Azure DevOps Services).","enum":["GITHUB","GITHUB_ENTERPRISE","GITLAB","BITBUCKET","BITBUCKET_DATACENTER","ADS"],"title":"Vcs Provider","type":"string"},"branch":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only pull requests from this branch.","title":"Branch"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items to return (1 to 100).","title":"First"},"after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous page's pageInfo.endCursor to continue after; leave empty for the first page.","title":"After"}},"required":["name","login","vcs_provider"],"title":"list_pull_requestsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_repository_issues":{"post":{"operationId":"list_repository_issues","summary":"List the distinct code issues raised on a repository's default branch (rule shortcode, title, category, severity, analyz","description":"List the distinct code issues raised on a repository's default branch (rule shortcode, title, category, severity, analyzer), optionally for one file path. Use for \"What kinds of code issues does DeepSource report on demo-go\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Repository name without the owner, for example 'demo-go'.","maxLength":100,"title":"Name","type":"string"},"login":{"description":"Login (username or organization name) of the DeepSource account, for example 'cyberdyne'.","maxLength":100,"title":"Login","type":"string"},"vcs_provider":{"description":"Source host of the account: GITHUB, GITHUB_ENTERPRISE, GITLAB, BITBUCKET, BITBUCKET_DATACENTER or ADS (Azure DevOps Services).","enum":["GITHUB","GITHUB_ENTERPRISE","GITLAB","BITBUCKET","BITBUCKET_DATACENTER","ADS"],"title":"Vcs Provider","type":"string"},"path":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Only issues with occurrences in this file path.","title":"Path"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items to return (1 to 100).","title":"First"},"after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous page's pageInfo.endCursor to continue after; leave empty for the first page.","title":"After"}},"required":["name","login","vcs_provider"],"title":"list_repository_issuesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_dependency_vulnerabilities":{"post":{"operationId":"list_dependency_vulnerabilities","summary":"List dependency vulnerabilities found on a repository's default branch with CVE identifier, severity, CVSS and EPSS scor","description":"List dependency vulnerabilities found on a repository's default branch with CVE identifier, severity, CVSS and EPSS scores, fixed versions, package and reachability. Use for \"Which vulnerable dependencies does my-app have according to DeepSource\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Repository name without the owner, for example 'demo-go'.","maxLength":100,"title":"Name","type":"string"},"login":{"description":"Login (username or organization name) of the DeepSource account, for example 'cyberdyne'.","maxLength":100,"title":"Login","type":"string"},"vcs_provider":{"description":"Source host of the account: GITHUB, GITHUB_ENTERPRISE, GITLAB, BITBUCKET, BITBUCKET_DATACENTER or ADS (Azure DevOps Services).","enum":["GITHUB","GITHUB_ENTERPRISE","GITLAB","BITBUCKET","BITBUCKET_DATACENTER","ADS"],"title":"Vcs Provider","type":"string"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items to return (1 to 100).","title":"First"},"after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous page's pageInfo.endCursor to continue after; leave empty for the first page.","title":"After"}},"required":["name","login","vcs_provider"],"title":"list_dependency_vulnerabilitiesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_repository_metrics":{"post":{"operationId":"get_repository_metrics","summary":"Get a repository's DeepSource metrics (such as line coverage): reporting flag, unit, latest value per key, threshold and","description":"Get a repository's DeepSource metrics (such as line coverage): reporting flag, unit, latest value per key, threshold and threshold status. Use for \"What is the current test coverage of demo-go on DeepSource\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Repository name without the owner, for example 'demo-go'.","maxLength":100,"title":"Name","type":"string"},"login":{"description":"Login (username or organization name) of the DeepSource account, for example 'cyberdyne'.","maxLength":100,"title":"Login","type":"string"},"vcs_provider":{"description":"Source host of the account: GITHUB, GITHUB_ENTERPRISE, GITLAB, BITBUCKET, BITBUCKET_DATACENTER or ADS (Azure DevOps Services).","enum":["GITHUB","GITHUB_ENTERPRISE","GITLAB","BITBUCKET","BITBUCKET_DATACENTER","ADS"],"title":"Vcs Provider","type":"string"}},"required":["name","login","vcs_provider"],"title":"get_repository_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}