# AceTeam.ai

> AI agent platform for building, managing, and deploying AI agents and workflow automation.

AceTeam exposes a Model Context Protocol (MCP) server so an AI assistant can
self-serve: manage agents, search knowledge bases, run workflows, send email,
manage calendars, and more. Point your AI at this file to discover everything.

## Connect via MCP

Endpoint (HTTP transport, Bearer `act_` API key): https://aceteam.ai/api/mcp/aceteam/mcp

IMPORTANT: get an API key at https://aceteam.ai/api-keys
(it is shown only once and starts with `act_`). With the stdio/mcp-remote flow
the user completes OAuth sign-in in a browser on first tool call; the AI
assistant cannot complete that step.

### Claude Code (HTTP transport, explicit key)

  claude mcp add --transport http aceteam "https://aceteam.ai/api/mcp/aceteam/mcp" -H "Authorization: Bearer act_YOUR_API_KEY_HERE"

### Claude Code (stdio via mcp-remote, OAuth in browser)

  claude mcp add aceteam -- npx -y mcp-remote@latest https://aceteam.ai/api/mcp/aceteam/mcp

### JSON config - HTTP transport (.mcp.json / client settings)

{
  "mcpServers": {
    "aceteam": {
      "type": "http",
      "url": "https://aceteam.ai/api/mcp/aceteam/mcp",
      "headers": {
        "Authorization": "Bearer act_YOUR_API_KEY_HERE"
      }
    }
  }
}

### JSON config - stdio via mcp-remote

  {"aceteam":{"command":"npx","args":["-y","mcp-remote@latest","https://aceteam.ai/api/mcp/aceteam/mcp"]}}

## Docs

### Agent Setup
- [Agent Index (this page)](https://aceteam.ai/docs/agent-index): AI-agent-optimized entry point: MCP install, setup steps, and the full docs index.
- [llms.txt](https://aceteam.ai/llms.txt): Machine-readable index of AceTeam docs and MCP setup, served as text/plain.
- [MCP Setup](https://aceteam.ai/mcp): One-command setup page for connecting AceTeam to an AI client.
- [Create an API Key](https://aceteam.ai/api-keys): Generate an `act_` API key to authenticate the MCP server (shown once).

### Getting Started
- [Platform Overview](https://aceteam.ai/docs/platform-overview): What AceTeam is, its key features, and who it's built for.
- [Account Setup](https://aceteam.ai/docs/account-setup): Sign up, create your organization, invite team members, and configure billing.
- [Organizations Across Your Devices](https://aceteam.ai/docs/organizations-and-devices): How your active organization is remembered separately on each device or browser you sign in on.
- [Projects](https://aceteam.ai/docs/projects): Organize agents, workflows, and resources into projects.
- [Creating Your First Agent](https://aceteam.ai/docs/first-agent): Build and test your first AI agent in under 5 minutes.
- [Creating Your First Workflow](https://aceteam.ai/docs/first-workflow): Build a multi-step automation with the visual workflow editor.
- [Ace CLI Setup](https://aceteam.ai/docs/ace-cli-setup): Install the Ace CLI and run AI workflows locally from your terminal.

### Agents
- [Agent Builder](https://aceteam.ai/docs/agent-builder): Configure AI agents with the Workbench: models, prompts, parameters, and tools.
- [Agent Tools & MCP](https://aceteam.ai/docs/agent-tools-mcp): Extend agents with tools using the Model Context Protocol.
- [Voice Agents](https://aceteam.ai/docs/voice-agents): Enable real-time voice conversations and phone calls with your agents.

### Workflows
- [Workflow Editor](https://aceteam.ai/docs/workflow-editor): Navigate the visual DAG editor to build multi-step automations.
- [Workflow Nodes](https://aceteam.ai/docs/workflow-nodes): Understand the node types available in the workflow editor.
- [Workflow Triggers](https://aceteam.ai/docs/workflow-triggers): Start workflows manually, on a schedule, via webhook, or from events.
- [Workflow Execution](https://aceteam.ai/docs/workflow-execution): Run workflows, monitor progress, and handle errors.

### Sovereign Compute
- [AceTeam Executive Overview](https://aceteam.ai/docs/executive-overview): A business-oriented introduction to AceTeam: AI infrastructure you own and control.
- [Sovereign AI Compute Platform](https://aceteam.ai/docs/whitepaper): Technical whitepaper: how AceTeam turns distributed hardware into a managed AI factory.
- [Fabric Overview](https://aceteam.ai/docs/fabric-overview): Understand the Sovereign Compute Fabric: run AI on your own hardware.
- [Citadel Setup](https://aceteam.ai/docs/citadel-setup): Install the Citadel CLI, authenticate, and register your first compute node.
- [Coding Agent & File Browser](https://aceteam.ai/docs/coding-agent): Let your AI agent read, edit, and search code on your own machine. Browse files from the web UI.
- [Connecting Nodes](https://aceteam.ai/docs/connecting-nodes): Add compute nodes, manage preauth keys, and configure resource routing.
- [GPU Compute](https://aceteam.ai/docs/gpu-compute): Deploy models, monitor GPUs, benchmark performance, and manage power on your own hardware.
- [Sandboxes](https://aceteam.ai/docs/sandboxes): Run ephemeral Docker containers on your own hardware. Execute code, checkpoint state, and build custom environments.
- [ACET Compute Tokens](https://aceteam.ai/docs/acet-tokens): Purchase ACET tokens to pay for GPU inference on the Sovereign Compute Fabric. Programmatic registration for agents.
- [Citadel OS](https://aceteam.ai/docs/citadel-os): Pre-built VM image with GPU drivers, Docker, and Citadel pre-installed. Deploy a GPU node in minutes.

### Safety & Accountability
- [AEP Safety Proxy](https://aceteam.ai/docs/safety-proxy): A reverse proxy that intercepts every LLM call, detects PII and toxic content, enforces PASS/FLAG/BLOCK decisions, and tracks cost. Zero code changes.
- [Safety Detectors](https://aceteam.ai/docs/safety-detectors): How AEP's pluggable detector architecture works. Built-in detectors for PII, toxicity, and cost anomalies, plus how to write your own.
- [Trust Engine](https://aceteam.ai/docs/safety-trust-engine): AceTeam's ensemble-of-judges approach to AI safety evaluation. Calibrated confidence scores from diverse judge models, validated by academic research.
- [Hosted Instances](https://aceteam.ai/docs/instances-overview): Deploy AI agents as hosted containers with automatic safety enforcement. No infrastructure to manage: create an instance, pick a template, and your agent runs 24/7 with cost tracking and audit trails.
- [Quickstart: Deploy Your First Instance](https://aceteam.ai/docs/instances-quickstart): Create a hosted AI agent instance in under a minute. Pick a template, set a safety policy, and your agent is live with full safety enforcement.

### Protocol
- [Agentic Execution Protocol](https://aceteam.ai/docs/aep-overview): The protocol layer that makes multi-organization AI workflows accountable. Start here to understand why AEP exists and how to read the full specification.
- [Agent Compute Protocol](https://aceteam.ai/docs/acp-overview): The protocol that lets AI agents dynamically request compute resources at runtime. ACP is the compute substrate counterpart to AEP's accountability layer.
- [AEP Whitepaper](https://aceteam.ai/docs/aep-whitepaper): The complete Agentic Execution Protocol specification: cost accountability, provenance, and data governance for multi-organization AI workflows.

### API Reference
- [Authentication](https://aceteam.ai/docs/authentication): Generate API keys and authenticate requests to the AceTeam API.
- [SDK & API Quickstart](https://aceteam.ai/docs/sdks): Manage sandboxes, GPU compute, and ACET tokens from Python and TypeScript.
- [Endpoints Overview](https://aceteam.ai/docs/endpoints-overview): Explore available API endpoint groups and request/response formats.
- [Gateway API](https://aceteam.ai/docs/gateway): Route any OpenAI-compatible client through the AceTeam gateway for cost tracking, safety detection, model routing, and failover.

### FAQs
- [General FAQs](https://aceteam.ai/docs/general-faqs): Common questions about pricing, models, privacy, and team management.
- [Technical FAQs](https://aceteam.ai/docs/technical-faqs): Answers about rate limits, file sizes, WebSockets, and self-hosting.

### Company
- [AceTeam Whitepaper](https://aceteam.ai/docs/accountable-compute-whitepaper): Sovereignty, cost transparency, and data governance in the agent economy. Why AI infrastructure needs an accountability layer, and how AceTeam built one.
- [Strategic Overview](https://aceteam.ai/docs/strategic-overview): AceTeam: The Operating System for Sovereign AI