Forgejo (Gitea Fork) MCP Server for Mastra AIGive Mastra AI instant access to 4 tools to Create Token, Dispatch Workflow, Get Forgejo Version, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Forgejo (Gitea Fork) through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Forgejo (Gitea Fork) MCP Server for Mastra AI is a standout in the Loved By Devs category — giving your AI agent 4 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"forgejo-gitea-fork": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Forgejo (Gitea Fork) Agent",
instructions:
"You help users interact with Forgejo (Gitea Fork) " +
"using 4 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Forgejo (Gitea Fork)?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Forgejo (Gitea Fork) MCP Server
Connect your Forgejo or Gitea instance to any AI agent to streamline your DevOps and repository management workflows through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Forgejo (Gitea Fork) tool infrastructure. Connect 4 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Version Auditing — Retrieve detailed Forgejo and Gitea-compatible version information to ensure API compatibility across your infrastructure.
- Token Management — Generate new Personal Access Tokens (PATs) with specific scopes (read/write) using your BasicAuth credentials.
- CI/CD Automation — Trigger manual workflow dispatches for Forgejo Actions directly from the chat to start builds or deployments.
- Instance Inspection — Verify the health and configuration of your self-hosted Git service without leaving your development environment.
The Forgejo (Gitea Fork) MCP Server exposes 4 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 4 Forgejo (Gitea Fork) tools available for Mastra AI
When Mastra AI connects to Forgejo (Gitea Fork) through Vinkius, your AI agent gets direct access to every tool listed below — spanning git-repository, self-hosted, version-control, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create token on Forgejo (Gitea Fork)
Generates a new personal access token. Generate a new API token for a user
Dispatch workflow on Forgejo (Gitea Fork)
Trigger a manual workflow dispatch in Forgejo Actions
Get forgejo version on Forgejo (Gitea Fork)
Get detailed Forgejo version information
Get gitea version on Forgejo (Gitea Fork)
Get the Gitea-compatible version of the Forgejo instance
Connect Forgejo (Gitea Fork) to Mastra AI via MCP
Follow these steps to wire Forgejo (Gitea Fork) into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Forgejo (Gitea Fork) MCP Server
Mastra AI provides unique advantages when paired with Forgejo (Gitea Fork) through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Forgejo (Gitea Fork) without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Forgejo (Gitea Fork) tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Forgejo (Gitea Fork) + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Forgejo (Gitea Fork) MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Forgejo (Gitea Fork), process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Forgejo (Gitea Fork) as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Forgejo (Gitea Fork) on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Forgejo (Gitea Fork) tools alongside other MCP servers
Example Prompts for Forgejo (Gitea Fork) in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Forgejo (Gitea Fork) immediately.
"Check the Forgejo and Gitea-compatible versions of my instance."
"Generate a new API token named 'CI-Runner' with read:repository scope for user 'admin'."
"Trigger the 'deploy.yaml' workflow in the 'main-app' repository owned by 'dev-team'."
Troubleshooting Forgejo (Gitea Fork) MCP Server with Mastra AI
Common issues when connecting Forgejo (Gitea Fork) to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpForgejo (Gitea Fork) + Mastra AI FAQ
Common questions about integrating Forgejo (Gitea Fork) MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Adafruit IO
10 toolsManage Adafruit IO feeds, data points, dashboards, and triggers.
Datos Abiertos Castilla-La Mancha
5 toolsAccess the official Open Data portal of Castilla-La Mancha. Explore datasets, resources, and query tabular data directly through your AI agent.
Correios API (REST)
2 toolsTrack Brazilian postal objects and calculate shipping prices and deadlines directly through the official Correios REST API.
Dot Object Transformer
1 toolsFlatten deeply nested JSON objects into dot-notation keys, or reconstruct nested objects from flat dictionaries.