Gitea MCP Server

22 MCP tools for Gitea source code management — repositories, branches, pull requests, issues, organizations, and users.

Overview

The Gitea MCP Server provides 22 tools for interacting with the platform’s Gitea instance, which hosts all GitOps repositories and platform source code. Operators can browse repositories, inspect branches, review pull requests, manage issues, and query organization structure through Compass chat.

Property	Value
Port	50055
Transport	JSON-RPC at `/jsonrpc`
Namespace	`f3iai`
Backend	Gitea API at `http://gitea-http.gitea.svc.cluster.local:3000`

Tools

Repositories

Tool	Description
`gitea_list_repos`	List repositories, optionally filtered by owner or organization
`gitea_get_repo`	Get detailed repository information (size, default branch, description)
`gitea_list_repo_contents`	List files and directories at a path in a repository
`gitea_get_file_content`	Get the content of a specific file from a repository
`gitea_list_repo_topics`	List topics (tags) on a repository

Branches and Tags

Tool	Description
`gitea_list_branches`	List all branches in a repository
`gitea_get_branch`	Get details of a specific branch including latest commit
`gitea_list_tags`	List tags in a repository

Pull Requests

Tool	Description
`gitea_list_pull_requests`	List pull requests, filtered by state (open, closed, all)
`gitea_get_pull_request`	Get details of a specific pull request including diff stats
`gitea_list_pr_comments`	List comments on a pull request
`gitea_list_pr_files`	List files changed in a pull request

Issues

Tool	Description
`gitea_list_issues`	List issues, filtered by state, labels, or assignee
`gitea_get_issue`	Get details of a specific issue
`gitea_list_issue_comments`	List comments on an issue

Organizations

Tool	Description
`gitea_list_orgs`	List all organizations
`gitea_get_org`	Get details of a specific organization
`gitea_list_org_repos`	List repositories belonging to an organization
`gitea_list_org_members`	List members of an organization

Users

Tool	Description
`gitea_list_users`	List all Gitea users
`gitea_get_user`	Get details of a specific user
`gitea_list_user_repos`	List repositories owned by a user

Common Use Cases

“What repos does the admin org have?” — calls gitea_list_org_repos
“Show open PRs on federal-frontier-platform” — calls gitea_list_pull_requests
“What’s in the deploy/overlays directory?” — calls gitea_list_repo_contents
“Show me the kustomization.yaml for compass-api” — calls gitea_get_file_content
“List all branches on ffo-mcp-server” — calls gitea_list_branches

Authentication

The server authenticates to Gitea using an API token:

Environment Variable	Description
`GITEA_URL`	Gitea base URL (default: `http://gitea-http.gitea.svc.cluster.local:3000`)
`GITEA_TOKEN`	API token with read/write access

External access to Gitea is available via NodePort 30300 (HTTP) and 30022 (SSH).

Health Endpoints

Endpoint	Purpose
`/health`	Liveness — process is running
`/ready`	Readiness — can reach the Gitea API