# Vscode Plugin

> VS Code extension: AgentStack MCP (60+ tools). 8DNA, Rules Engine, Buffs, Payments. API key in SecretStorage, one-click project creation.

- **Type:** MCP server
- **Install:** `agentstack add mcp-agentstacktech-vscode-plugin`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [agentstacktech](https://agentstack.voostack.com/s/agentstacktech)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [agentstacktech](https://github.com/agentstacktech)
- **Source:** https://github.com/agentstacktech/vscode-plugin
- **Website:** https://agentstack.tech

## Install

```sh
agentstack add mcp-agentstacktech-vscode-plugin
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# AgentStack MCP — VS Code Extension

VS Code extension that connects **AgentStack MCP** so you can use the live AgentStack action catalog (Projects, Auth, Scheduler, Analytics, Rules Engine, Webhooks, Notifications, Wallets, Payments, Buffs, Agents, Storage, Support, and more) via one tool (`agentstack.execute`) from chat and agent mode.

JSON-based data store (8DNA: JSON+ with built-in variants, e.g. A/B tests) and server-side logic without boilerplate.

## Quick Start

1. **Install the extension** from the Marketplace or load the VSIX.
2. **Sign in** — run **AgentStack: Sign in with Device Code** for OAuth browser login. If OAuth is unavailable, run **AgentStack: Create project and get API key** or **AgentStack: Set API Key** as the fallback.
3. **Use in chat** — select **@agentstack** for read-only fast paths (list projects, stats) and LM tools (`agentstack_execute`, `agentstack_get_projects` when supported). For full catalog coverage use manual MCP setup in [MCP_QUICKSTART.md](MCP_QUICKSTART.md) or Copilot agent mode with MCP configured.

More options (curl, dashboard) in [MCP_QUICKSTART.md](MCP_QUICKSTART.md).

## What you can do

All actions are available in **Chat** when you select the **@agentstack** participant (through `agentstack.execute`). Example prompts by domain:

| Domain | Example prompts in chat |
|--------|-------------------------|
| **Projects** | **List my AgentStack projects**, **Get stats for a project**, **List users in the selected project** (slash commands) — the extension fetches real data from the API directly. Or say "list my projects", "get stats", "list users", "project details" / "список проектов", "статистика", "пользователи проекта". For other requests (e.g. "Create a project named Test") the model uses MCP tools; responses use only tool data, never invented examples. |
| **8DNA / Data** | "Store project data at key config.theme", "Read user data" |
| **Rules Engine** | "Create a rule when user signs up", "List logic rules" |
| **Buffs** | "Give user a 7-day trial", "List active buffs" |
| **Payments** | "Create a payment", "Get wallet balance" |
| **Auth** | "Get my profile", "Quick auth with email" |
| **Scheduler, Analytics, Webhooks, Notifications, Wallets** | "Schedule a task", "Get analytics", "List webhooks" |

**Full tool list and parameters:** [Capability Matrix](https://github.com/agentstacktech/AgentStack/blob/master/docs/MCP_CAPABILITY_MATRIX.md), generated from `GET /mcp/actions`.

**After creating a project:** The API key is saved in the extension and used automatically. To copy it elsewhere, run **AgentStack: Set API Key** (paste the same key) or **AgentStack: Show API key & project info** (preview and copy).

## What this extension does

| Feature | Description |
|--------|-------------|
| **Stable MCP setup path** | Marketplace build avoids proposed APIs. Use the sidebar/chat participant directly, or follow `MCP_QUICKSTART.md` to add the MCP server in VS Code manually. |
| **Ecosystem view** | **AgentStack** sidebar: **Status** (Set API key / Connected); **Projects** — **Refresh**, **Create project**, then your projects (or "No projects — Create project"); **Project detail** (when a project is selected) — Summary, Data (preview), **Users**, **Settings**, **Scheduler** (if you have read permission: list tasks, run from tree; use Chat to create), **Capabilities** (Buffs, Payments, Rules, 8DNA — links to docs; use @agentstack in Chat for more), **Unselect project**; **Documentation** (MCP Server Capabilities, 8DNA & Key-Value API, Plugins index). Right-click any node for context menu (e.g. Copy project ID, Refresh). |
| **Project data & settings** | From the tree: **Summary** / **Data (preview)** → **AgentStack: Show project data in editor** (full project JSON); **Settings** → **AgentStack: Open project settings in editor** (view/edit `data.config`). After editing the JSON, run **AgentStack: Save project settings from editor** to push changes via MCP. Use **Unselect project** under Project detail to clear selection. User data (`user.data`) is available via key-value API — see Documentation → 8DNA; for per-user data you can ask in Chat (@agentstack). |
| **Status bar** | Shows "AgentStack (ProjectName)" or "AgentStack (project id)" when a project is selected, or "Set API key"; click to set key or see key & project info. |
| **Open documentation** | **AgentStack: Open documentation** (Command Palette) opens the Plugins index and doc links. |
| **Create project and get key** | **AgentStack: Create project and get API key** — creates an anonymous project (no account), saves the API key, and connects MCP in one step. |
| **OAuth / API key** | OAuth Device Code stores a Bearer token in SecretStorage. API keys remain a fallback through **AgentStack: Set API Key**. |
| **Project switcher** | **AgentStack: Switch project** shows a QuickPick of real projects and stores the selected project for sidebar/chat context. |
| **Chat skills** | 22 domain skills for @agentstack (projects, hosting, storage, support, rag, agents, commerce, messenger, …) — decision-first routing; live catalog via `GET /mcp/actions`. |

## AgentStack vs “just a database”

| Capability | AgentStack | Typical DB-only |
|------------|------------|-----------------|
| Data model | 8DNA (JSON+): structured JSON; key-value store (`project.data`, `user.data`); built-in support for variants (e.g. A/B tests) | Flat tables |
| Server logic | Rules Engine (when/do, no code) | Triggers / custom backend |
| Trials & subscriptions | Buffs | Custom or 3rd party |
| Payments | Built-in gateway | Separate integration |
| API surface | One MCP tool (`agentstack.execute`) with live action discovery + REST APIs | CRUD + auth |

## Settings

- **API key** — From Settings or command; empty = use key from secure storage (Set API Key).
- **Base URL** — MCP server URL (default: `https://agentstack.tech/mcp`). Change only for self-hosted AgentStack.
- **Request timeout** — Timeout for MCP/server calls in seconds (1–300, default 60).
- **Enable Chat Participant** — Turn @agentstack chat on/off.
- **Debug / Strip artifacts** — Toggle if chat output looks wrong (e.g. raw tool names in the answer). Enable **Debug Chat Response** and check **Output → AgentStack MCP** to see whether the response came from the direct API path or from the model (helps diagnose fake/example project lists).

## If something doesn't work

- **@agentstack doesn't show or chat says it's unavailable** — Command Palette (Ctrl+Shift+P) → **Developer: Reload Window**. Then run **AgentStack: Set API Key** or **AgentStack: Create project and get API key** once, and try @agentstack in Chat again.
- **Where does AgentStack MCP appear?** — The Marketplace build does not register MCP through proposed APIs. Use the **@agentstack** chat participant and sidebar commands, or follow **MCP_QUICKSTART.md** to add the MCP server manually through VS Code's stable/user setup flow.
- **AgentStack tools still not available** — Reload the window, run any AgentStack command from the Command Palette, then open Chat and choose @agentstack. Check **Output → AgentStack MCP** for trace-first diagnostics.

## Documentation

- **This plugin:** [github.com/agentstacktech/vscode-plugin](https://github.com/agentstacktech/vscode-plugin)
- **Quick Start (API key):** [MCP_QUICKSTART.md](MCP_QUICKSTART.md)
- **Plugin ↔ MCP flow (auth, client, errors):** [docs/PLUGIN_MCP_FLOW.md](docs/PLUGIN_MCP_FLOW.md)
- **Full MCP tool list:** [Capability Matrix](https://github.com/agentstacktech/AgentStack/blob/master/docs/MCP_CAPABILITY_MATRIX.md) (generated from live MCP actions)
- **Plugins index (Cursor, Claude, GPT, VS Code):** [docs/plugins/README.md](https://github.com/agentstacktech/AgentStack/blob/master/docs/plugins/README.md)

## Links

- **AgentStack:** [agentstack.tech](https://agentstack.tech)
- **LinkedIn:** [linkedin.com/company/agentstacktech](https://www.linkedin.com/company/agentstacktech/)
- **GitHub:** [github.com/agentstacktech](https://github.com/agentstacktech)

*For maintainers:* [TESTING_AND_CAPABILITIES.md](TESTING_AND_CAPABILITIES.md).

## License

MIT. See [LICENSE](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [agentstacktech](https://github.com/agentstacktech)
- **Source:** [agentstacktech/vscode-plugin](https://github.com/agentstacktech/vscode-plugin)
- **License:** MIT
- **Homepage:** https://agentstack.tech

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-agentstacktech-vscode-plugin
- Seller: https://agentstack.voostack.com/s/agentstacktech
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.