Documentation

Everything you need to deploy, configure, and manage Aliion for your organization.

Getting Started

Set up Aliion in under 5 minutes

Agent Installation

Deploy agents to discover MCP servers

API Reference

Integrate with the Aliion API

Security & Compliance

Learn about our security practices

Getting Started

1

Create Account

Sign up for a free Aliion account and create your organization.

2

Generate API Key

Go to Settings → API Keys and generate a key for your agent.

3

Install Agent

Run the agent on your systems to discover MCP servers automatically.

Agent Installation

Install via pip

pip install aliion-agent

Configure Environment

# Set your API key (get this from Settings → API Keys)
export ALIION_API_KEY="your_api_key_here"

# Optional: Set a custom agent name
export ALIION_AGENT_NAME="my-workstation"

Start the Agent

aliion-agent start

The agent will automatically discover MCP servers from your Claude Desktop configuration and report them to your Aliion dashboard.

Agent Commands

  • aliion-agent startStart the agent
  • aliion-agent discoverDiscover MCP servers
  • aliion-agent statusShow agent status
  • aliion-agent info <name>Server details
  • aliion-agent initInitialize config file

Configuration Options

  • --api-keyYour Aliion API key
  • --agent-nameCustom agent name
  • --heartbeat-intervalHeartbeat frequency (seconds)
  • --discovery-intervalDiscovery frequency (seconds)
  • --log-levelLogging verbosity

API Reference

Base URL

https://aliion-api.slmood.workers.dev/api
GET/agentsList all agents
GET/serversList discovered MCP servers
POST/servers/:id/approveApprove an MCP server
POST/servers/:id/denyDeny an MCP server
GET/policiesList all policies
POST/policiesCreate a new policy
GET/agents/api-keysList API keys
POST/agents/api-keysGenerate new API key
POST/agents/heartbeatAgent heartbeat

All API requests require authentication via Authorization: Bearer TOKEN or X-API-Key header.

Guides & Tutorials

5 min read

Quick Start Guide

Get up and running with Aliion in minutes. Learn how to create an account, install your first agent, and discover MCP servers.

10 min read

Agent Deployment

Learn how to deploy Aliion agents across your infrastructure to automatically discover and monitor MCP servers.

5 min read

API Key Management

Generate and manage API keys for programmatic access to your Aliion dashboard and agent authentication.

8 min read

Policy Configuration

Create policies to automatically approve, deny, or flag MCP servers based on risk scores and other criteria.

5 min read

Team Management

Invite team members, assign roles, and manage permissions across your organization.

7 min read

MCP Server Approval Workflow

Configure approval workflows for new MCP server discoveries based on risk assessment.

Need Help?

Can't find what you're looking for? Our team is here to help you get the most out of Aliion.