Origin MCP tool reference

Every tool the Origin MCP server at https://api.origin.cursor.com/mcp lists, in listing order. Parameters are the JSON Schema clients receive from tools/list.

get_repository

Get one Origin repository by owner and name, including default branch and mirror state.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:metadata:read

Parameters

Returns

id, owner, name, fullName, defaultBranch, cloneUrl, mirror

list_repositories

List Origin repositories belonging to an owner slug.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: namespace:repositories:read

Parameters

Limits

• pageSize defaults to 30 and is at most 100.
• Pass the previous response's nextPageToken as pageToken to read the next page.

Returns

repositories (paged), nextPageToken

list_namespaces

List the Origin namespaces (owner slugs) the caller can list repositories in, ordered by slug. Each slug is a valid owner for list_repositories; viewerCanCreateRepositories reports whether creating a repository there would be allowed. An empty list means the caller has no Origin repositories to read; repositories on GitHub or other hosts are not reachable through these tools.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: namespace:repositories:read

Parameters

Limits

• pageSize defaults to 30 and is at most 100.
• Pass the previous response's nextPageToken as pageToken to read the next page.

Returns

namespaces (paged), nextPageToken

create_repository

Create an empty Origin-hosted repository. Pick an owner from list_namespaces where viewerCanCreateRepositories is true; omit owner to use the caller's personal namespace, which Origin claims on first use (needs an eligible plan, a Privacy Mode that allows code storage, and no team membership; team members pass their team slug). Both steps are one approval: confirm with the user before calling. defaultBranch defaults to main. Repository names are unique per owner, so retrying after a success fails with a conflict; read the repository with get_repository instead. Returns the created repository, including cloneUrl.

• Access: Writes
• Asks for confirmation: Yes
• On the read-only endpoint: No
• Required scopes: namespace:repositories:create

Parameters

Returns

id, owner, name, fullName, defaultBranch, cloneUrl

get_file_contents

Read one path at a ref in an Origin-hosted repository. Files larger than the byte cap are truncated. A directory returns type dir and its immediate children as entries (name, path, type, sha, and size for files) instead of content; entries past the cap are dropped and truncated is set.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:contents:read

Parameters

Limits

• content is truncated after 256 KiB.
• A line range covers at most 500 lines.

Returns

files (at most 1), path, content, encoding, sha, truncated, type, entries (at most 1000), name, size

get_git_tree

List a git tree in an Origin-hosted repository at a tree SHA, commit SHA, branch, tag, or HEAD: immediate children by default, or the full walk with recursive true. Each entry is path, mode, type (blob, tree, or commit), sha, and size for blobs. Entries past the cap are dropped and truncated is set; list subtrees non-recursively to see more. get_file_contents reads one blob.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:contents:read

Parameters

Returns

sha, entries (at most 1000), path, mode, type, size, truncated

grep_contents

Search file contents across one Origin-hosted repository at a ref, which defaults to the default branch. The query is a regular expression matched case-sensitively; set literal for exact text, or caseInsensitive to ignore case (regex mode prefixes (?i) for GrepContents). wholeWord applies only with literal; for regex use \b. Returns matching lines plus any requested context lines, capped at 1000 matching occurrences, and sets limitHit when that cap is reached. Each returned line contains its full text, so the occurrence cap does not bound response bytes. There is no pagination. Narrow query, filterPath, includes, or excludes to reach other matches.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:contents:read

Parameters

Limits

• query must be set.
• query is at most 4 KiB of UTF-8.
• filterPath is at most 4 KiB of UTF-8.
• includes takes at most 20 items.
• excludes takes at most 20 items.
• includes is at most 4 KiB of UTF-8.
• excludes is at most 4 KiB of UTF-8.
• maxResults is clamped to at most 1000.
• contextBefore is clamped to at most 10.
• contextAfter is clamped to at most 10.

Returns

matches (at most 21000), path, lineNumber, line, kind, submatches (at most 1000), limitHit

list_branches

List branch names and tip commit SHAs for an Origin-hosted repository. Optional prefix filters each page after pagination.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:contents:read

Parameters

Limits

• pageSize defaults to 30 and is at most 100.
• Pass the previous response's nextPageToken as pageToken to read the next page.

Returns

branches (paged), nextPageToken

list_commits

List commits from a branch or starting ref in an Origin-hosted repository, optionally filtered by lists of exact git author or committer emails and by inclusive since and until bounds on committer time. A commit matches a list when its email equals any listed email, and must match every list and bound that is given. Email and time filters share one scan of at most 1000 commits per page, so a filtered page can be short or empty while nextPageToken is present. Keep paging to reach older matches. Each item is sha, full message, author, committer, parents, and tree. Omits patches. Continuation calls reuse the filters stored in pageToken.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:contents:read

Parameters

Limits

• pageSize defaults to 30 and is at most 100.
• Pass the previous response's nextPageToken as pageToken to read the next page.
• authorEmails takes at most 100 items.
• committerEmails takes at most 100 items.

Returns

commits (paged), nextPageToken

commit_read

Read one commit in an Origin-hosted repository. Choose a single view: metadata, files, or a bounded patch.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:contents:read

Parameters

Limits

• pageSize defaults to 30 and is at most 100.
• Pass the previous response's nextPageToken as pageToken to read the next page.
• view is one of metadata, files, patch.
• Long patch output is returned in chunks.
• A line range covers at most 500 lines.

Returns

Set view to choose what comes back:

• metadata: sha, message, author, committer, stats, parents
• files: files (paged), path, status, additions, deletions, changes, previousFilename
• patch: patch (chunked), truncated

compare_commits

Compare two refs of an Origin-hosted repository relative to their merge base.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:contents:read

Parameters

Returns

mergeBase, aheadBy, behindBy, status

list_pull_requests

List pull requests in an Origin-hosted repository, filtered by state, head, author, base, or direction and sorted by creation or update time. Items are compact summaries (author, timestamps, merged/closedAt/mergedAt, and stack membership when the pull request is stacked); they omit body and diff stats—use pull_request_read for those. Continuation calls must resend those filters with pageToken.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:pull_requests:read

Parameters

Limits

• pageSize defaults to 30 and is at most 100.
• Pass the previous response's nextPageToken as pageToken to read the next page.
• state is one of open, closed, all.
• direction is one of desc, asc.
• sortBy is one of created, updated.

Returns

pullRequests (paged), nextPageToken

pull_request_read

Read one Origin-hosted pull request through a single view: summary, files, commits, reviews, comments, or threads. Summary includes labels, requested reviewers, and stack membership (stack id and parent pull request) when the pull request is stacked. The threads view requires threadIds and pages comments in those threads.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:pull_requests:read, repository:pull_requests:reviews:read

Parameters

Limits

• pageSize defaults to 30 and is at most 100.
• Pass the previous response's nextPageToken as pageToken to read the next page.
• view is one of summary, files, commits, reviews, comments, stack, threads.
• threadIds takes at most 20 items.
• Long patch output is returned in chunks.
• A line range covers at most 500 lines.

Returns

Set view to choose what comes back:

• summary: number, title, state, draft, merged, author, base, head, createdAt, updatedAt, closedAt, mergedAt, body, additions, deletions, changedFiles, stack, labels (at most 100), requestedReviewers (at most 100)
• files: files (paged), path, status, additions, deletions, changes, patch (chunked), truncated
• commits: commits (paged)
• reviews: reviews (paged), id, body, verdict, author, submittedAt
• comments: comments (paged), id, body, threadId, author, createdAt, updatedAt
• stack (not yet public): parent, children (paged), mergePrefix, convergence
• threads: threads (paged)

create_pull_request

Create a pull request from an already-pushed branch. Optionally stack it on a parent pull request.

• Access: Writes
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:write

Parameters

Returns

number, title, state, draft, head, base, stackParent

update_pull_request

Update a pull request's title, description, and lifecycle through the public fields. Omit title or body to leave that field unchanged; pass an empty body to clear the description. Lifecycle is state (open or closed) plus draft, sent independently: state closed closes and ignores draft; state open reopens, and without draft true marks ready and publishes an existing draft; draft true reopens as a draft, alone or together with state open; draft false marks ready and reopens a closed pull request. Send one lifecycle field, both, or neither, so a metadata-only update is valid. Metadata and lifecycle together send one public UpdatePullRequest. Origin applies present fields in its documented order; a failure can leave some fields applied, so re-read after an error. merged is not writable, and ready is draft false or state open rather than a state value.

• Access: Writes
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:write

Parameters

Limits

• state is one of open, closed.

Returns

number, title, body, state, draft

merge_pull_request

Merge a pull request or its root-to-target stack prefix. Requires the expected head SHA. Optional mergeMethod (merge or squash); omit for the repository's default. skippedDescendants is currently always empty; descendants above a mid-stack merge target remain open.

• Access: Destructive
• Asks for confirmation: Yes
• On the read-only endpoint: No
• Required scopes: repository:contents:write

Parameters

Limits

• expectedHeadSha must be set.
• mergeMethod is one of merge, squash.

Returns

mergeCommitSha, mergedPrefix (at most 200), skippedDescendants (at most 100)

create_pull_request_review

Submit a comment, approval, or request-changes review on a pull request. Inline review comments are unsupported.

• Access: Writes content other people see
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Limits

• event is one of COMMENT, APPROVE, REQUEST_CHANGES.

Returns

id, state, body

update_pull_request_review

Correct the body of an existing pull request review.

• Access: Writes content other people see
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Returns

id, state, body

dismiss_pull_request_review

Dismiss a submitted approve or request-changes review.

• Access: Destructive
• Asks for confirmation: Yes
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Returns

id, state, dismissal

create_pull_request_comment

Create a general discussion comment on a pull request.

• Access: Writes content other people see
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Returns

id, body

create_pull_request_inline_comment

Create a file-level, single-line, or line-range inline comment, optionally against a specific pull request version.

• Access: Writes content other people see
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Limits

• A line range covers at most 500 lines.

Returns

threadId, id, path, line, body

reply_pull_request_review_thread

Reply to an existing review thread by thread ID.

• Access: Writes content other people see
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Limits

• threadId must be set.

Returns

id, threadId, body, createdAt, updatedAt

update_pull_request_review_thread

Resolve or reopen a review thread by thread ID.

• Access: Writes content other people see
• Asks for confirmation: Yes
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Limits

• threadId must be set.

Returns

threadId, resolved

update_pull_request_comment

Correct an existing pull request comment body.

• Access: Writes content other people see
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Returns

id, body, threadId, createdAt, updatedAt

update_pull_request_labels

Replace every label on a pull request with the provided names. Each name must be an existing repository label, spelled exactly, including case; this tool never creates labels. For a label that does not exist yet, call create_label first, then call this tool. Omitted labels are removed. An empty list removes all labels.

• Access: Writes
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:write

Parameters

Limits

• labels takes at most 100 items.

Returns

labels (at most 100)

create_label

Create a repository label so update_pull_request_labels can apply it. label is the name: 1-50 characters, trimmed, and unique in the repository by exact, case-sensitive spelling, so Bug and bug are different labels; reuse an existing label that differs only in case instead of creating another. color is six hex digits with an optional leading #, such as d73a4a; it defaults to ededed. description is optional, at most 255 characters. A name that already exists returns a conflict; apply that label instead.

• Access: Writes
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:labels:write

Parameters

Limits

• label must be set.

Returns

name, color, description

request_pull_request_reviewers

Request reviewers (users and/or groups) on a pull request.

• Access: Writes content other people see
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Limits

• users takes at most 100 items.
• groups takes at most 100 items.

Returns

users (at most 100), groups (at most 100)

remove_pull_request_reviewers

Remove requested reviewers from a pull request.

• Access: Writes content other people see
• Asks for confirmation: No
• On the read-only endpoint: No
• Required scopes: repository:pull_requests:reviews:write

Parameters

Limits

• users takes at most 100 items.
• groups takes at most 100 items.

Returns

status: one of completed.

checks_read

Read checks for one target in an Origin-hosted repository: a pull request, commit, suite, or run. Rollup covers materialized check runs on the current page only and is omitted when nextPageToken is present. Does not fetch external provider logs.

• Access: Read-only
• Asks for confirmation: No
• On the read-only endpoint: Yes
• Required scopes: repository:checks:read, repository:pull_requests:read

Parameters

Limits

• pageSize defaults to 30 and is at most 100.
• Pass the previous response's nextPageToken as pageToken to read the next page.
• target.type is one of pull_request, commit, suite, run.

Returns

rollupStatus, failing (paged), suites (paged), runs (paged), nextPageToken