# Superblocks MCP

> Superblocks MCP connects your AI agent directly to your low-code platform infrastructure. It lets you manage internal applications, monitor automated workflows, and handle full application lifecycle tasks—all using natural language commands. Need to audit configurations or generate secure session tokens for embedded apps? This MCP gives your agent the necessary tools to interact with every part of your Superblocks ecosystem without needing UI clicks.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** internal-tools, low-code, workflow-automation, api-integration, app-management, scheduled-jobs

## Description

You can use this MCP connection to control your entire low-code environment through simple conversation. Instead of jumping between dashboards, you tell your AI client what you need done—whether it's listing all available applications or figuring out which workflows are failing.

It gives your agent the power to perform critical infrastructure tasks like creating a brand new internal application, updating an existing one, or deleting obsolete resources entirely. You can also pull up a full list of every active workflow running in the background so you know exactly what kind of automated logic is firing off across the company.

If you have end-users that need to access specific Superblocks tools, your agent can generate secure session tokens right on the fly, making SSO integration much simpler. When you subscribe through Vinkius, you give any MCP-compatible client instant access to this full suite of controls, letting you treat platform management like a natural conversation with an expert developer.

## Tools

### create_application
This tool builds a brand new Superblocks application within your organization.

### create_embed_token
It generates an authenticated session token for users embedding the Superblocks applications using SSO.

### delete_application
The tool permanently removes a specific Superblocks application from your setup.

### get_application
It pulls detailed configuration information for one app, using its unique identifier.

### list_applications
This tool retrieves a paginated list of every application currently running in the organization.

### list_workflows
It lists all active background workflows and scheduled jobs associated with your account.

### update_application
You can use this tool to change the configuration details of an existing Superblocks application.

## Prompt Examples

**Prompt:** 
```
List the first 10 applications in our Superblocks organization.
```

**Response:** 
```
I've retrieved the first 10 applications. You have tools like 'Customer Support Dashboard' (ID: app_123) and 'Inventory Manager' (ID: app_456) active. Would you like details on any specific one?
```

**Prompt:** 
```
Show me the configuration for application ID app_789.
```

**Response:** 
```
Fetching details for app_789... This is the 'Sales Analytics' app. It currently has 3 pages and connects to your Snowflake and Salesforce instances. Would you like to see the full JSON payload?
```

**Prompt:** 
```
Generate an embed token for user 'dev@example.com' for our embedded portal.
```

**Response:** 
```
I've generated a secure session token for dev@example.com. You can now use this token to authenticate their session in your embedded Superblocks components.
```

## Capabilities

### Audit and list apps
Your agent can quickly list every application in your organization or fetch detailed configurations for one specific app.

### Manage the full app lifecycle
You can programmatically create, update, or delete entire Superblocks applications using simple commands.

### Monitor automated workflows
The agent retrieves a comprehensive list of all active background processes and scheduled jobs running across your platform.

### Generate secure access tokens
You can request authenticated session tokens for embedded applications, enabling single sign-on (SSO) for end-users.

## Use Cases

### The forgotten app
A Platform Engineer suspects an old dashboard is leaking data. They ask their agent to list all applications and find the ID. Then, they use `get_application` to pull the full configuration payload and confirm it needs deletion via `delete_application`.

### Client review access
A Product Manager needs a stakeholder to test an embedded dashboard in staging. They ask their agent, which uses `create_embed_token`, generating the necessary session token right in the chat for immediate testing.

### Workflow debugging
The Ops team notices payments aren't processing overnight. They prompt their agent to list all workflows (`list_workflows`), identify the payment job, and check its last run status immediately.

### Launching a new feature module
A developer is ready to build an internal tool but needs boilerplate setup. They use `create_application` via their agent, instantly spinning up the necessary Superblocks shell and configuration structure.

## Benefits

- Control the full app lifecycle: You can create, update, or delete applications directly through your agent. No more needing to navigate complex admin UIs just to make a quick config change.
- Streamline SSO setup: Need temporary access for an auditor? Use the `create_embed_token` tool to instantly generate secure session tokens without touching any manual user management screens.
- Deep visibility into operations: The agent can list all active workflows (`list_workflows`), letting you monitor scheduled jobs and backend logic without guessing which services are running.
- Audit apps easily: Use `list_applications` or `get_application` to quickly audit configurations. You get the exact JSON payload, making it easy for engineers to validate settings.
- Faster onboarding: Product teams can list available internal tools instantly via your agent, giving them a real-time inventory without needing developer help.

## How It Works

The bottom line is you manage complex internal tools using only chat commands, without ever leaving your preferred AI environment.

1. First, subscribe to this MCP on Vinkius and provide your Superblocks API Key.
2. Next, prompt any AI client with a natural language request (e.g., 'List all apps that need updating').
3. The agent executes the necessary function call, retrieves the data payload, and presents the result back to you in conversation.

## Frequently Asked Questions

**How do I list applications using Superblocks MCP?**
You use the `list_applications` tool. This pulls a paginated inventory of every app in your organization, giving you an immediate overview without needing to navigate the UI.

**Can I update configurations with Superblocks MCP?**
Yes, you can use the `update_application` tool. Just provide the application ID and the new configuration data, and your agent handles making those changes programmatically.

**Does Superblocks MCP handle workflow monitoring?**
Absolutely. The `list_workflows` tool lets you retrieve a full list of all active background jobs so you can monitor scheduled tasks across your platform.

**How do I generate an embed token using Superblocks MCP?**
Use the `create_embed_token` tool. You pass the necessary user details, and the agent returns a secure session token ready for embedding in external systems.

**What if I want to delete an old app with Superblocks MCP?**
Use the `delete_application` tool. The agent executes the removal process on your behalf, allowing you to clean up obsolete resources from your chat interface.