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

# Station Overview

> Lightweight runtime for deployable AI sub-agents

## What is Station?

Station is a secure, self-hosted platform for managing AI agents with MCP (Model Context Protocol) tool integration. It provides:

* **AI Agent Runtime**: Execute agents with any AI provider (OpenAI, Gemini, Anthropic, Ollama)
* **MCP Server**: Expose agents as MCP tools for AI editors like Claude Desktop and Cursor
* **Management UI**: Web-based interface for configuration and monitoring
* **Bundle System**: Package and distribute agent configurations

## Architecture

```mermaid theme={null}
graph TB
    subgraph "Station"
        API[REST API :8585]
        MCP[MCP Server :8586]
        SSH[SSH Admin :2222]
        DB[(SQLite)]
    end
    
    subgraph "External"
        AI[AI Provider]
        Tools[MCP Tools]
        Editor[AI Editor]
    end
    
    API --> DB
    MCP --> DB
    SSH --> DB
    
    API --> AI
    MCP --> Tools
    Editor --> MCP
```

## Key Concepts

### Environments

Station organizes configurations into **environments** (e.g., `default`, `production`, `development`). Each environment has its own:

* Agents
* MCP server configurations
* Variables

```
~/.config/station/
├── config.yaml              # Global settings
├── station.db               # SQLite database
└── environments/
    ├── default/
    │   ├── template.json    # MCP servers config
    │   ├── variables.yml    # Environment variables
    │   └── agents/
    │       └── my-agent.prompt
    └── production/
        └── ...
```

### Agents

Agents are defined as `.prompt` files using dotprompt format:

```yaml theme={null}
---
name: code-reviewer
description: Reviews code for best practices
model: openai/gpt-4o
tools:
  - filesystem_read
  - github_pr_comments
---

You are an expert code reviewer. Analyze the provided code and suggest improvements.
```

### MCP Servers

MCP servers provide tools to your agents. Configure them in `template.json`:

```json theme={null}
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    }
  }
}
```

### Bundles

Bundles package complete environment configurations for easy distribution:

```bash theme={null}
# Create a bundle from your environment
stn bundle create default --output my-bundle.tar.gz

# Install a bundle from CloudShip
stn bundle install <bundle-uuid> my-environment
```

## Running Modes

| Mode       | Command     | Use Case                             |
| ---------- | ----------- | ------------------------------------ |
| **Server** | `stn serve` | Local development, direct API access |
| **Docker** | `stn up`    | Isolated deployment, CI/CD           |
| **stdio**  | `stn stdio` | Direct MCP integration with editors  |

## Next Steps

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/station/installation">
    Install Station on your system
  </Card>

  <Card title="Onboarding" icon="rocket" href="/station/onboarding">
    Complete the initial setup process
  </Card>
</CardGroup>