mcp-aerostack — Aerostack Developer MCP

Turn any AI coding agent into a full-stack Aerostack developer. Plan integrations, build bots, generate workflows, create private MCPs, and publish to marketplace — all through conversation.

Aerostack is a developer platform for building AI-native backends on the edge. This MCP server gives your AI agent (Claude Code, Cursor, Windsurf, or any MCP-compatible tool) the ability to plan and execute end-to-end integrations — from analyzing what services are needed, through building missing connectors, to deploying production workflows.

Instead of clicking through a dashboard or writing boilerplate, just describe what you want: "Connect my Notion to Ocoya — post new pages as social media content every hour" — and your AI agent handles everything.

---

What You Can Do

Orchestrate Integrations (NEW)

• Plan — Describe an integration in plain English. The agent searches the marketplace, detects gaps (missing MCPs), determines credential requirements, and returns a structured execution plan.
• Build Missing MCPs — When a service isn't in the marketplace, get a complete MCP template. Your AI editor writes the implementation, deploys as a private MCP.
• One-Call Setup — Create workspace, add MCPs, store encrypted secrets, verify health — all in one step.
• Auto-Generate Workflows — Agent discovers available tools, builds the trigger → read → transform → write pipeline automatically.
• Publish to Marketplace — Share your private MCPs with the community. Quality standards enforced automatically.

Build & Deploy

• AI Bots — Telegram, Discord, WhatsApp, and Slack bots with LLM-powered workflows.
• Visual Workflows — 16 node types: LLM calls, logic, loops, MCP tools, code blocks, auth gates, scheduled messages, human handoffs.
• Custom Functions — TypeScript functions deployed to the edge with full runtime access (Cache, Database, AI, Queue, Vector Search, Storage).
• AI Endpoints — Expose workflows as REST APIs with manual, scheduled, and webhook triggers.

---

Available Tools (17)

CRUD Tools (1-10)

Tool	Description
guide	Contextual help — platform setup, node schemas, credential requirements, runtime APIs. 18+ topics.
list	List resources: bots, workflows, endpoints, webhooks, functions, workspace tools, templates.
get	Get full details — config, workflow graph, credential status, deployment state.
create	Create resources. Bot credentials validated + encrypted. Functions auto-deployed.
update	Partial updates. Functions auto-redeployed. Workspace secrets encrypted (AES-256-GCM).
delete	Delete with reference checking — won't delete a workflow used by a bot.
validate	Pre-flight checks: graph validation, bot config, function code safety.
test	Execute with test input — per-node execution logs for workflows.
deploy	Go live: register webhooks, publish workflows, push functions to edge.
scaffold	Generate complete resource from natural language description.

Orchestration Tools (11-17)

Tool	Description
plan	The brain — Analyze integration request, search marketplace, detect gaps, return execution plan with credentials + workflow shape.
capabilities	Get MCP tools grouped by read/write/search, auth requirements, config schema.
build_spec	Generate MCP server template for AI editors — boilerplate, tool stubs, aerostack.toml, README.
sdk_docs	SDK reference: MCP templates, function templates, auth patterns, deploy/test guides.
setup_integration	One-call workspace setup: create workspace + add MCPs + store secrets + verify health.
generate_workflow	Auto-build workflow from workspace tools: trigger → source → transform → destination.
publish	Publish private MCP to marketplace with quality gate validation.

---

Integration Flow

1. plan("connect Notion to Ocoya")
   → Finds Notion MCP ✓, Ocoya not found ✗
   → Returns: credentials needed, workflow shape, next steps

2. build_spec({ service: "ocoya", tools: ["create_post"] })
   → Returns MCP template for your AI editor to implement

3. create({ type: "function", config: { code: "...", visibility: "private" } })
   → Deploys private MCP to edge

4. setup_integration({ name: "Notion → Ocoya", servers: [...], secrets: {...} })
   → Creates workspace, adds MCPs, stores encrypted secrets

5. generate_workflow({ workspace_id: "...", intent: "Post Notion pages to Ocoya" })
   → Auto-builds trigger → read → transform → write pipeline

6. test + deploy → Live!

7. publish({ function_id: "..." })
   → Optional: share your Ocoya MCP on the marketplace

---

Configuration

Variable	Required	Description
AEROSTACK_API_KEY	Yes	Account key (starts with ak_, never expires). Get from aerostack.dev → Settings → CLI Keys.

Quick Start

Connect Your AI Agent

Claude Code (.claude/mcp-config.json):

{
  "mcpServers": {
    "aerostack": {
      "url": "https://mcp.aerostack.dev/ws/YOUR_WORKSPACE_SLUG",
      "headers": {
        "Authorization": "Bearer YOUR_WORKSPACE_TOKEN"
      }
    }
  }
}

Example Conversations

Plan an integration:

You: "I want to sync GitHub issues to Linear whenever they're labeled as 'bug'"

Agent: → plan() finds both MCPs available
       → setup_integration() creates workspace with both MCPs
       → generate_workflow() builds: webhook trigger → github.get_issue → transform → linear.create_issue
       → Asks for GitHub token + Linear API key
       → Deploys workflow

Build a missing MCP:

You: "Connect Notion to Ocoya for social media posting"

Agent: → plan() finds Notion ✓, Ocoya ✗
       → build_spec("ocoya") gives template
       → Writes Ocoya MCP implementation
       → Deploys as private MCP
       → Wires workflow
       → Suggests publishing to marketplace

---

Deployment

This MCP is deployed privately from the Aerostack monorepo:

# Build + deploy to dev
AEROSTACK_API_KEY=ak_... npm run deploy:dev

# Build + deploy to production
AEROSTACK_API_KEY=ak_... npm run deploy:prod

Source code is NOT in the public aerostack-market repo.