gitea/gitea-mcp

{
  "service_type": "platform",
  "base_url": "https://gitea.com",
  "auth_method": "custom",
  "auth_config": {
    "type": "api_token",
    "required": true,
    "header": "Authorization",
    "header_prefix": "token",
    "parameter_name": "token",
    "note": "Token must be provided to the MCP server via environment variable or config file."
  },
  "endpoints": [
    "GET /api/v1/version",
    "GET /api/v1/user",
    "GET /api/v1/repos/search",
    "GET /api/v1/repositories/{owner}/{repo}",
    "GET /api/v1/repos/{owner}/{repo}/issues",
    "POST /api/v1/repos/{owner}/{repo}/issues",
    "GET /api/v1/repos/{owner}/{repo}/pulls",
    "POST /api/v1/repos/{owner}/{repo}/pulls",
    "GET /api/v1/repos/{owner}/{repo}/commits",
    "GET /api/v1/repos/{owner}/{repo}/contents/*",
    "PUT /api/v1/repos/{owner}/{repo}/contents/*",
    "DELETE /api/v1/repos/{owner}/{repo}/contents/*",
    "GET /api/v1/repos/{owner}/{repo}/branches",
    "POST /api/v1/repos/{owner}/{repo}/branches",
    "GET /api/v1/repos/{owner}/{repo}/releases",
    "POST /api/v1/repos/{owner}/{repo}/releases"
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "provider": "Gitea (the project and gitea.com hosting)",
      "cost": "Gitea is open-source and self-hostable for free; gitea.com offers free accounts with limits (e.g., 3 repos for anonymous, 10 repos for free accounts) and paid plans for higher usage.",
      "self_hosting": "Free to use, no license cost.",
      "cloud": "Freemium with upgrade options for more storage, collaborators, or advanced features."
    }
  },
  "rate_limits": {
    "api": "Default Gitea API rate limits apply (typically based on token or IP). gitea.com may impose stricter limits on anonymous requests.",
    "note": "Exact limits not documented for this MCP wrapper; refer to Gitea instance settings."
  },
  "capabilities": [
    "Repository management (create, view, search repos)",
    "Issue tracking (read, create, update issues)",
    "Pull request management (read, create, review)",
    "File operations (read, write, delete files in repos)",
    "Branch management (create, list branches)",
    "Release management (view, create releases)",
    "User and account features (view user info)",
    "Search across repositories and content",
    "Integration with Git workflows via API",
    "Multi-platform support (works with any Gitea instance, including self-hosted and cloud)",
    "Cross-platform (macOS, Windows, Linux) as noted in description"
  ],
  "raw_analysis": "The service at https://gitea.com/gitea/gitea-mcp is a Model Context Protocol (MCP) server that acts as an adapter to interact with Gitea instances programmatically. Gitea is a lightweight, self-hosted Git service alternative to GitHub or GitLab. This MCP tool enables AI assistants or LLM-based applications to perform Git-related operations—such as managing repositories, issues, pull requests, files, branches, and releases—through a standardized interface. It is designed for developers and teams who use Gitea, whether self-hosted or via gitea.com cloud hosting. The platform is mature: Gitea is widely adopted, actively maintained, and has a robust REST API. The MCP integration is an evolving layer but leverages the underlying stable API. It is client-agnostic and works with any Gitea instance, given an API token. Authentication requires a token, which can be handled via environment variables or configuration. There is no built-in web UI in this MCP service; it only exposes tool endpoints for AI consumption. Pricing follows Gitea's model: self-hosted is free, while gitea.com is freemium. Rate limits are not explicitly documented for the MCP wrapper but inherit those of the target Gitea instance. The description's emojis (🎖️🏎️☁️🏠🍎🪟🐧) indicate support for both cloud and on-premises deployment across two OSes. This service is specifically used as an MCP server, so it requires an MCP client (e.g., Claude Desktop, Continue) to function."
}

2/3 tests passed

```json
{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 6.5,
    "first_try_success": 4.0,
    "response_parseability": 8.0,
    "error_clarity": 5.5,
    "doc_quality": 5.0,
    "auth_simplicity": 4.0,
    "latency": 8.5,
    "consistency": 6.0
  },
  "pricing_normalized": {
    "cost_per_month_free": 0,
    "entry_paid_tier_usd": 5,
    "trial_available": true
  },
  "issues": [
    "No llms.txt found (404) — harder for agents to discover platform capabilities programmatically",
    "No unified getting-started guide specifically for AI agents on Gitea.com",
    "Free tier limits (3 repos anonymous, 10 repos for free accounts) could block agent workflows without early paid upgrade",
    "Documentation appears fragmented across self-hosted Gitea and gitea.com hosting — different auth flows may confuse agents",
    "Auth requires standard login (username/password or pat), no SSO or magic link for agent-first onboarding"
  ],
  "recommendations": [
    "Add llms.txt with structured capability descriptions and API endpoint summaries",
    "Create agent-specific onboarding doc showing exact sequence: register → create token → verify repo access",
    "Expose a public API playground or sandbox with sample repos for testing before committing users to accounts",
    "Document rate limits and any free-tier repo count ceilings clearly to avoid agent failures",
    "Consider offering OAuth basic client flow for third-party agent platforms with scoped tokens"
  ]
}
```