# Gitea — how to use (mcp.ai)

Connect your Gitea account and use 19 tools for developer tools straight from your AI agent. Connect with your own API key. Community managed lightweight code hosting solution written in Go.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_gitea?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `gitea_activitypub_person`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/gitea`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/gitea/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/gitea/activitypub/person` — Tool to retrieve the ActivityPub Person actor for a Gitea user. Use when you need to fetch a user's ActivityPub representation for federation purposes or to get ActivityStreams-formatted user data.
  - body: { user_id: integer }
- `POST https://api.mcp.ai/api/gitea/get/general/api/settings` — Tool to retrieve the Gitea instance's global API settings including pagination limits and response size constraints. Use when you need to understand API rate limits or configuration parameters.
- `POST https://api.mcp.ai/api/gitea/get/general/attachment/settings` — Tool to retrieve the Gitea instance's global settings for file attachments including enabled status, allowed file types, size limits, and file count limits. Use when you need to understand the attachm
- `POST https://api.mcp.ai/api/gitea/get/general/repository/settings` — Tool to retrieve the Gitea instance's global settings for repositories including feature flags for mirroring, HTTP Git, migrations, stars, time tracking, and LFS. Use when you need to understand which
- `POST https://api.mcp.ai/api/gitea/get/general/ui/settings` — Tool to retrieve the Gitea instance's global settings for UI including default theme, allowed reactions, and custom emojis. Use when you need to understand the UI configuration of the instance.
- `POST https://api.mcp.ai/api/gitea/get/gitignore/template/info` — Tool to retrieve information about a specific gitignore template. Use when you need the content of a gitignore template for repository creation or configuration.
  - body: { name: string }
- `POST https://api.mcp.ai/api/gitea/get/label/template/info` — Tool to retrieve all labels from a specific label template. Use when you need to view the predefined label set for repository configuration.
  - body: { name: string }
- `POST https://api.mcp.ai/api/gitea/get/license/template/info` — Tool to retrieve information about a specific license template. Use when you need the content and details of a license template for repository creation or configuration.
  - body: { name: string }
- `POST https://api.mcp.ai/api/gitea/get/node/info` — Tool to retrieve the nodeinfo of the Gitea application. Use when you need standardized metadata about the Gitea server following the NodeInfo specification.
- `POST https://api.mcp.ai/api/gitea/get/signing/key` — Tool to retrieve the default GPG signing key used by Gitea to sign commits. Use when you need to verify commits signed by the Gitea instance or import the public key to trust Gitea-generated commits.
- `POST https://api.mcp.ai/api/gitea/get/version` — Tool to retrieve the version of the Gitea application. Use when you need to check the Gitea server version.
- `POST https://api.mcp.ai/api/gitea/list/gitignore/templates` — Tool to retrieve all available gitignore templates. Use when creating a repository to select an appropriate .gitignore template.
- `POST https://api.mcp.ai/api/gitea/list/label/templates` — Tool to retrieve all available label templates. Use when you need to discover which predefined label sets are available for repositories.
- `POST https://api.mcp.ai/api/gitea/list/license/templates` — Tool to retrieve all available license templates. Use when creating a repository to select an appropriate license template.
- `POST https://api.mcp.ai/api/gitea/org/get/all` — Tool to retrieve a paginated list of all organizations in the Gitea instance. Use when you need to list all organizations or browse organizations with pagination support.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/gitea/org/list/actions/secrets` — Tool to list all action secrets for an organization. Use when you need to retrieve the list of secrets configured at the organization level. Note that secret values are never returned through the API 
  - body: { org: string, page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/gitea/render/markdown` — Tool to render a markdown document as HTML with configurable rendering modes and context. Use when you need to convert markdown to HTML with specific rendering contexts like comments, wiki pages, or f
  - body: { mode?: string, text: string, wiki?: boolean, context?: string }
- `POST https://api.mcp.ai/api/gitea/render/markdown/raw` — Tool to render raw markdown text as HTML. Use when you need to convert markdown content to HTML format for display or processing.
  - body: { markdown_text: string }
- `POST https://api.mcp.ai/api/gitea/render/markup` — Tool to render a markup document as HTML with support for multiple markup formats. Use when you need to convert markup content (Markdown, AsciiDoc, etc.) to HTML with specific rendering contexts like 
  - body: { mode?: string, text: string, wiki?: boolean, context?: string, file_path?: string }

## Example prompts
- "What can I do in Gitea?"
- "Show me a summary of my Gitea account"

## More
- Page: https://mcp.ai/gitea
- Agent spec (llms.txt): https://mcp.ai/gitea/llms.txt
- Postman collection: https://mcp.ai/gitea/postman.json