> ## Documentation Index
> Fetch the complete documentation index at: https://fentaris.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

<div className="fentaris-home px-4 py-8 mt-10 lg:pb-16 max-w-5xl mx-auto">
  <div className="text-center">
    <img noZoom src="https://mintcdn.com/fentaris/dKUFQSpa5eoHcHse/assets/logo-white-trasparent.png?fit=max&auto=format&n=dKUFQSpa5eoHcHse&q=85&s=e2f13ee7d5b5588dcbe3728713e2906f" className="mx-auto h-40 w-auto" alt="Fentaris" width="1254" height="1254" data-path="assets/logo-white-trasparent.png" />
  </div>

  <div className="max-w-2xl mx-auto px-4 mt-6 text-center">
    <p className="text-xl">The centralized MCP proxy</p>
    <p className="mt-3">Route multiple MCP servers, enforce policy per user, and observe every tool call.</p>
  </div>

  <div className="mt-8 grid sm:grid-cols-3 gap-4 max-w-2xl mx-auto text-center text-sm">
    <div><b>Unify</b><br /><span className="text-zinc-500">heterogeneous MCP servers</span></div>
    <div><b>Protect</b><br /><span className="text-zinc-500">policy, auth, and middleware</span></div>
    <div><b>Observe</b><br /><span className="text-zinc-500">logs, checks, and profiler events</span></div>
  </div>

  <div className="px-6 lg:px-0 mt-10">
    <CardGroup cols={3}>
      <Card title="Get started" icon="sparkles" href="/getting-started/quickstart">
        Build a working proxy in minutes.
      </Card>

      <Card title="Tutorial" icon="map" href="/getting-started/tutorial">
        Walk through a full setup with middleware and hooks.
      </Card>

      <Card title="Team example" icon="users" href="/guides/team-governed-proxy">
        Copy a governed proxy with users, groups, policy, and secrets.
      </Card>
    </CardGroup>
  </div>

  <div className="px-6 lg:px-0 mt-4">
    <CardGroup cols={3}>
      <Card title="Agent Skills" icon="bot" href="/getting-started/codex-skills">
        Let an agent guide setup and project changes.
      </Card>

      <Card title="Agent guide" icon="bot-message-square" href="/guides/agent-implementation">
        Follow the implementation rules and validation checklist.
      </Card>

      <Card title="Runnable example" icon="users" href="/examples/team-governed-proxy">
        Run API-key auth, groups, policy, a remote upstream, and local tools.
      </Card>
    </CardGroup>
  </div>
</div>

## Quickstart

<Tabs>
  <Tab title="Agent">
    Use this path when you want Codex, Claude Code, or another supported agent to ask setup questions and create the project with the right users, upstream MCP servers, credentials, and policy defaults.

    ```bash theme={null} theme={"theme":{"light":"github-light","dark":"github-dark"}}
    npx skills add Fentaris/fentaris-skills --skill '*'
    ```

    Restart or reload your agent, then ask it to create a Fentaris proxy:

    ```txt theme={null} theme={"theme":{"light":"github-light","dark":"github-dark"}}
    Use $fentaris-project-setup to help me create a Fentaris proxy for my team.
    ```

    The setup skill should inspect the target workflow, generate or update the proxy project, and run local validation before handing the project back.

    [Agent Skills](/getting-started/codex-skills)
  </Tab>

  <Tab title="CLI">
    Use this path when you want a generated Fentaris project with `fentaris.json`, package scripts, a starter TypeScript entrypoint, and CLI checks.

    ```bash theme={null} theme={"theme":{"light":"github-light","dark":"github-dark"}}
    npm i -g @fentaris/cli
    fentaris init my-proxy
    cd my-proxy
    fentaris dev
    ```

    The generated proxy listens on `http://localhost:4000/mcp` by default. Use this route for the fastest local project that can later add auth, policy, and more upstream MCP servers.

    [Quickstart](/getting-started/quickstart)
  </Tab>

  <Tab title="Manual">
    Use this path when you already have a TypeScript project or need to wire Fentaris directly into an existing app without generated files.

    ```bash theme={null} theme={"theme":{"light":"github-light","dark":"github-dark"}}
    npm i @fentaris/core
    ```

    ```ts theme={null} theme={"theme":{"light":"github-light","dark":"github-dark"}}
    import { fentaris, stdio } from "@fentaris/core";

    const app = fentaris();

    app.mcp("filesystem", {
      transport: stdio({
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
      }),
    });

    await app.start();
    ```

    Manual setup gives you the high-level API directly: declare upstream MCP servers, choose transports, then add identity, policy, middleware, and observability as the project grows.

    [Manual setup](/getting-started/setup)
  </Tab>
</Tabs>

## Explore Fentaris

<CardGroup cols={3}>
  <Card title="Architecture" icon="layers" href="/concepts/architecture">
    How Fentaris routes requests and manages sessions.
  </Card>

  <Card title="Policies" icon="shield" href="/concepts/policies">
    Control which tools, resources, prompts, and completions users can access.
  </Card>

  <Card title="Transports" icon="terminal" href="/concepts/servers-and-transports">
    Connect MCP servers through stdio and Streamable HTTP patterns.
  </Card>
</CardGroup>

<CardGroup cols={3}>
  <Card title="Proxy setup" icon="router" href="/guides/proxy-setup">
    A production-shaped proxy configuration.
  </Card>

  <Card title="Team-governed proxy" icon="users" href="/guides/team-governed-proxy">
    A complete runnable project with expected allowed and denied outputs.
  </Card>

  <Card title="CLI Usage" icon="terminal" href="/reference/cli">
    Run, validate, build, and inspect Fentaris projects.
  </Card>
</CardGroup>

<CardGroup cols={3}>
  <Card title="Observability" icon="activity" href="/guides/observability">
    Structured logs, health checks, and runtime profiler workflows.
  </Card>

  <Card title="Agent implementation" icon="bot-message-square" href="/guides/agent-implementation">
    Decision table and handoff checklist for coding agents.
  </Card>

  <Card title="API map" icon="route" href="/reference/api-map">
    Find the right Fentaris API by implementation task.
  </Card>
</CardGroup>

***

<div className="mt-10 border-t border-zinc-800 pt-6 pb-12 text-sm text-zinc-500">
  <div className="flex flex-col gap-2">
    <div>Fentaris is a centralized MCP proxy for routing, policy, auth, and observability.</div>

    <div>
      Useful links: <a href="/reference-auto/index">API Reference (Auto)</a>,
      <a href="/reference-auto/api-map">API Reference Map</a>,
      <a href="/reference/cli">CLI Reference</a>,
      <a href="/getting-started/tutorial">Tutorial</a>,
      <a href="/examples/team-governed-proxy">Team-governed example</a>.
    </div>
  </div>
</div>