Install from Hub

The Aerostack Hub hosts 30+ community MCP servers — GitHub, Stripe, Slack, Notion, Linear, Sentry, and more. Install any of them into your workspace with one command. They run on Cloudflare edge via service bindings, so there is no server for you to manage.

Prerequisites

An Aerostack account at aerostack.dev
The Aerostack CLI installed and authenticated
A workspace created (see Quick Start)

Browse Available MCP Servers

Browse the full catalog at aerostack.dev/hub. Each listing shows:

Server name and description
Available tools (e.g., create_issue, list_pull_requests)
Required secrets (e.g., GITHUB_TOKEN)
Install count and rating

Click Install to add it to your workspace from the web.

Install an MCP Server

Choose and install

aerostack mcp install @aerostack/github-mcp

If you have multiple workspaces, specify which one:

aerostack mcp install @aerostack/github-mcp --workspace my-workspace

Configure required secrets

Most MCP servers need API credentials. The CLI prompts you interactively:

# -> @aerostack/github-mcp requires the following secrets:
# -> GITHUB_TOKEN: A GitHub personal access token with repo scope
# -> Enter GITHUB_TOKEN: ghp_xxxxxxxxxxxx
# -> Secret stored (AES-GCM encrypted in your workspace).

You can also set secrets non-interactively:

aerostack secrets set github-mcp GITHUB_TOKEN "ghp_xxxxxxxxxxxx"

Secrets are encrypted with AES-GCM before storage. They are injected as headers at request time. Team members who connect via workspace tokens never see the raw API key. See Secrets and Security for details.

Verify the installation

aerostack mcp list
# Workspace: my-workspace
# -------------------------------------------------
# @aerostack/github-mcp    v2.1.0    github__create_issue, github__list_pull_requests, ...
# @aerostack/slack-mcp     v1.4.2    slack__send_message, slack__create_channel, ...

The tools are now available through your workspace gateway URL. No editor config change needed.

Available MCP Servers

A selection of popular servers on the Hub:

Server	Tools	Required Secrets
`@aerostack/github-mcp`	Issues, PRs, repos, actions, search	`GITHUB_TOKEN`
`@aerostack/stripe-mcp`	Customers, charges, subscriptions, invoices	`STRIPE_API_KEY`
`@aerostack/slack-mcp`	Messages, channels, users, reactions	`SLACK_BOT_TOKEN`
`@aerostack/notion-mcp`	Pages, databases, blocks, search	`NOTION_API_KEY`
`@aerostack/linear-mcp`	Issues, projects, cycles, teams	`LINEAR_API_KEY`
`@aerostack/sentry-mcp`	Issues, events, releases, projects	`SENTRY_AUTH_TOKEN`
`@aerostack/cloudflare-mcp`	Workers, databases, cache, storage, DNS	`CF_API_TOKEN`
`@aerostack/postgres-mcp`	SQL queries against any Postgres database	`DATABASE_URL`
`@aerostack/resend-mcp`	Send and manage emails	`RESEND_API_KEY`

Browse the full list at aerostack.dev/hub.

Managing Installed Servers

Update to latest version

# Update a specific server
aerostack mcp update @aerostack/github-mcp
 
# Update all servers in your workspace
aerostack mcp update --all

Remove a server

aerostack mcp remove @aerostack/github-mcp
# -> Removed github__create_issue, github__list_pull_requests, ... from workspace

Removing a server also removes its secrets from your workspace.

Change secrets

# Rotate an API key
aerostack secrets set github-mcp GITHUB_TOKEN "ghp_new_token_here"
# -> Secret updated. Takes effect on next tool call.

How Hub Servers Work

When you install from the Hub, the MCP server runs on Cloudflare edge via service bindings. The flow:

Key points:

The MCP server runs on Cloudflare edge — no cold starts, globally distributed
Your API key is decrypted and injected by the gateway, not stored in the MCP server itself
Every call is logged with the workspace token identity for analytics

Install via Admin Dashboard

You can also install MCP servers from the web:

Go to the Admin dashboard

Navigate to MCP Servers in the left sidebar.

Click “Browse Hub”

This opens the Hub catalog within the dashboard.

Click “Install” on the server you want

The dashboard prompts you for any required secrets.

Enter secrets and confirm

The server appears in your workspace immediately.

Discover Tools at Runtime

Your workspace gateway includes a built-in find_skill meta-tool. Your AI assistant can discover and suggest new MCP servers mid-conversation:

You: "I need to check our Sentry errors."
Agent: I found @aerostack/sentry-mcp on the Hub. Want me to install it?
You: "Yes."
Agent: Installed. Fetching your recent Sentry issues now...

Next Steps

Quick Start Host on Aerostack