gitea.com
Gitea is a self-hosted and hosted Git forge for source code hosting, code review, issues, packages, and related collaboration workflows. The `gitea.com` domain hosts the public service and its documentation.
Gitea exposes a REST API at `https://gitea.com/api/v1` plus an OAuth2/OpenID Connect provider on the main host; documented auth options include personal access tokens, HTTP Basic auth, SSH-based HTTP signatures, and OAuth2 app credentials.
- Gitea OAuth2 / OpenID Connect providerdiscovered
- Gitea REST APIdiscovered
In Gitea, open User Settings → Applications and use Manage Access Tokens to create a token. Choose the needed permission scopes; Gitea shows the token only once. The docs also note tokens can be minted via the API at /api/v1/users/{username}/tokens using HTTP Basic auth with your username and password.
Sign in to your Gitea account at gitea.com login. The API docs state HTTP Basic authentication is supported, and that creating tokens via /api/v1/users/{username}/tokens specifically requires Basic auth with your username and password.
Add an SSH public key or SSH certificate to your Gitea account in User Settings → SSH / GPG Keys. Then sign API requests with the matching private key using the draft-cavage HTTP Signatures format; send the signature in the Signature header, and include x-ssh-certificate when using an SSH certificate.
Register an OAuth2 application in Gitea from User Settings → Applications or, for admins, the instance application pages described in the docs. Create an app with a name and redirect URL, then copy the generated Client ID and Client Secret. Use those in the standard OAuth flow against Gitea’s OAuth endpoints; user consent is required.
conventions · 0/7 published
- integrations.json——
- llms.txt✗
/llms.txt - API catalog✗
/.well-known/api-catalog - OpenAPI document✗
/api/schema/, /openapi.json, /swagger.json, /api/openapi.json, or /v1/openapi.json - MCP server card✗
/.well-known/mcp/server-card.json - OAuth protected resource✗
/.well-known/oauth-protected-resource - Agent card✗
/.well-known/agent-card.json - Agent skills✗
/.well-known/agent-skills/index.json
Publish these signals → /publishing