gitea-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GITEA_URL | Yes | Base URL of your Gitea instance (e.g. https://gitea.example.com) | |
| GITEA_TOKEN | Yes | Personal access token with appropriate permissions |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gitea_versionA | Get the Gitea MCP server version and service version. |
| gitea_writeA | Gitea write operations — create or update resources (POST/PUT/PATCH). operation='help' — list ops with parameter names + types. operation='help' params={'search':'X'} — same, filtered to ops whose name contains X (case-insensitive). operation='schema' — JSON Schema for one op. params={'op': 'OpName'} or params={} to list op names. operation='' params={...} — invoke. Params validated strictly: unknown keys, wrong types, missing required → ValueError with field-level detail. |
| gitea_admin_writeA | Gitea admin write operations (POST/PUT/PATCH/DELETE /admin/*) and admin-scope actions like running cron jobs. operation='help' — list ops with parameter names + types. operation='help' params={'search':'X'} — same, filtered to ops whose name contains X (case-insensitive). operation='schema' — JSON Schema for one op. params={'op': 'OpName'} or params={} to list op names. operation='' params={...} — invoke. Params validated strictly: unknown keys, wrong types, missing required → ValueError with field-level detail. |
| gitea_admin_readB | Gitea admin read operations (GET /admin/*). operation='help' — list ops with parameter names + types. operation='help' params={'search':'X'} — same, filtered to ops whose name contains X (case-insensitive). operation='schema' — JSON Schema for one op. params={'op': 'OpName'} or params={} to list op names. operation='' params={...} — invoke. Params validated strictly: unknown keys, wrong types, missing required → ValueError with field-level detail. |
| gitea_readA | Gitea read operations — safe, GET-only. operation='help' — list ops with parameter names + types. operation='help' params={'search':'X'} — same, filtered to ops whose name contains X (case-insensitive). operation='schema' — JSON Schema for one op. params={'op': 'OpName'} or params={} to list op names. operation='' params={...} — invoke. Params validated strictly: unknown keys, wrong types, missing required → ValueError with field-level detail. |
| gitea_deleteA | Gitea delete operations (DELETE) — destructive. operation='help' — list ops with parameter names + types. operation='help' params={'search':'X'} — same, filtered to ops whose name contains X (case-insensitive). operation='schema' — JSON Schema for one op. params={'op': 'OpName'} or params={} to list op names. operation='' params={...} — invoke. Params validated strictly: unknown keys, wrong types, missing required → ValueError with field-level detail. |
| gitea_executeA | Gitea action triggers — merge PRs, dispatch workflows, and other side-effecting actions beyond plain CRUD. operation='help' — list ops with parameter names + types. operation='help' params={'search':'X'} — same, filtered to ops whose name contains X (case-insensitive). operation='schema' — JSON Schema for one op. params={'op': 'OpName'} or params={} to list op names. operation='' params={...} — invoke. Params validated strictly: unknown keys, wrong types, missing required → ValueError with field-level detail. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
The tools are divided by operation category (read, write, delete, etc.) with clear names, but there is overlap: gitea_delete and gitea_admin_write both handle DELETE operations, and gitea_execute may overlap with gitea_write for actions like merge PR. An agent may be uncertain which umbrella tool to use for a given operation.
All tools share the gitea_ prefix and use snake_case, which is consistent. However, gitea_version is a noun while the others are verbs (read, write, delete, execute), a minor deviation from the otherwise verb-based pattern.
With 7 tools, the count is well within the typical range for a server that wraps a full API. Each umbrella tool covers a broad category of operations, making the top-level count compact and manageable.
The set covers the core domains: version info, read/write/delete operations, admin read/write, and side-effecting actions. The split between gitea_write and gitea_execute is somewhat redundant for certain actions, and there is no dedicated search tool, but overall coverage is strong.