Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions apps/docs/content/docs/mcp-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@ Superset provides an [MCP (Model Context Protocol)](https://modelcontextprotocol
|----------|------------|
| **Tasks** | list, get (by id or slug), create, update, delete, list statuses |
| **Workspaces** | list (per host), create on a host, update, delete |
| **Agents** | list agents on a host, launch an agent session in a workspace |
| **Terminals** | create in a workspace, list, send input, read screen, close |
| **Automations** | list, get metadata, get/set prompt body, create, update metadata, pause, resume, run on demand, list runs, delete |
| **Projects** | list projects on a host |
| **Hosts** | list hosts (registered machines) you have access to |
Expand Down Expand Up @@ -318,6 +320,10 @@ API keys grant full access to your organization. Keep them secret and never comm
| Tool | Description |
|------|-------------|
| `terminals_create` | Create a terminal session in a workspace, optionally running a command |
| `terminals_list` | List terminal sessions in a workspace |
| `terminals_send` | Write text into a running terminal (presses Enter by default) |
| `terminals_read` | Read the terminal screen as plain text (current screen plus recent scrollback) |
| `terminals_close` | Close a terminal session and kill its process |

### Automations

Expand Down
2 changes: 1 addition & 1 deletion apps/marketing/src/lib/llms.ts
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ export function buildDeveloperResourcesSection(): string[] {
"",
`- [API docs](${docsUrl}/mcp-server): Superset MCP server documentation`,
`- [OpenAPI spec](${API_URL}/openapi.json): OpenAPI 3.1 description of the Superset API surface`,
`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — 27 tools for tasks, workspaces, agents, automations, terminals, hosts, and projects. Alias: ${API_URL}/mcp`,
`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Keep the marketing category list aligned with the MCP documentation.

Line 56 omits the Organization capability, which is documented in apps/docs/content/docs/mcp-server.mdx at Line 25. Add organization to this list, or make the wording explicitly non-exhaustive (for example, “including tools for…”).

Suggested fix
-		`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`,
+		`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, projects, and organization; full catalog in the server card. Alias: ${API_URL}/mcp`,
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`,
`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, projects, and organization; full catalog in the server card. Alias: ${API_URL}/mcp`,
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/marketing/src/lib/llms.ts` at line 56, Update the MCP server description
in the marketing category list to include the documented Organization
capability, or revise the wording to explicitly indicate the tools list is
non-exhaustive while preserving the existing description.

`- [Docs MCP server](${docsUrl}/mcp): search and read the Superset documentation over MCP (Streamable HTTP, no auth)`,
`- [MCP server card](${baseUrl}/.well-known/mcp/server-card.json): machine-readable MCP server description`,
`- [A2A agent card](${baseUrl}/.well-known/agent-card.json): Agent-to-Agent capability card`,
Expand Down
13 changes: 13 additions & 0 deletions packages/sdk/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,10 +96,23 @@ Types:

- <code><a href="./src/resources/terminals.ts">TerminalCreateParams</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalCreateResult</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalListParams</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalListResult</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalSummary</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalSendParams</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalSendResult</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalReadParams</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalReadResult</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalCloseParams</a></code>
- <code><a href="./src/resources/terminals.ts">TerminalCloseResult</a></code>

Methods:

- <code title="host post /api/trpc/terminal.createSession">client.terminals.<a href="./src/resources/terminals.ts">create</a>({ hostId, workspaceId, command?, cwd? }) -> TerminalCreateResult</code>
- <code title="host post /api/trpc/terminal.listSessions">client.terminals.<a href="./src/resources/terminals.ts">list</a>({ hostId, workspaceId }) -> TerminalListResult</code>
- <code title="host post /api/trpc/terminal.send">client.terminals.<a href="./src/resources/terminals.ts">send</a>({ hostId, workspaceId, terminalId, text, submit? }) -> TerminalSendResult</code>
- <code title="host post /api/trpc/terminal.snapshot">client.terminals.<a href="./src/resources/terminals.ts">read</a>({ hostId, workspaceId, terminalId, maxLines? }) -> TerminalReadResult</code>
- <code title="host post /api/trpc/terminal.killSession">client.terminals.<a href="./src/resources/terminals.ts">close</a>({ hostId, workspaceId, terminalId }) -> TerminalCloseResult</code>

# Automations

Expand Down
Loading