diff --git a/packages/types/src/api.ts b/packages/types/src/api.ts
index 440d1a4e30..d2832d60e4 100644
--- a/packages/types/src/api.ts
+++ b/packages/types/src/api.ts
@@ -2,6 +2,10 @@
  * API for programmatic MCP server operations
  */
 
+import type { EventEmitter } from "events"
+import type { RooCodeEvents } from "./events.js"
+import type { RooCodeSettings, ProviderSettings, ProviderSettingsEntry } from "./index.js"
+
 /**
  * Interface for MCP operations that can be accessed programmatically
  */
@@ -13,6 +17,47 @@ export interface McpApi {
 	refreshMcpServers(): Promise<void>
 }
 
+/**
+ * Main API interface for Roo Code extension
+ */
+export interface RooCodeAPI extends EventEmitter<RooCodeEvents>, McpApi {
+	// Task Management
+	startNewTask(options: {
+		configuration: RooCodeSettings
+		text?: string
+		images?: string[]
+		newTab?: boolean
+	}): Promise<string>
+	resumeTask(taskId: string): Promise<void>
+	isTaskInHistory(taskId: string): Promise<boolean>
+	getCurrentTaskStack(): unknown
+	clearCurrentTask(lastMessage?: string): Promise<void>
+	cancelCurrentTask(): Promise<void>
+	cancelTask(taskId: string): Promise<void>
+
+	// Messaging
+	sendMessage(text?: string, images?: string[]): Promise<void>
+	pressPrimaryButton(): Promise<void>
+	pressSecondaryButton(): Promise<void>
+
+	// State
+	isReady(): boolean
+
+	// Configuration
+	getConfiguration(): RooCodeSettings
+	setConfiguration(values: RooCodeSettings): Promise<void>
+
+	// Profile Management
+	getProfiles(): string[]
+	getProfileEntry(name: string): ProviderSettingsEntry | undefined
+	createProfile(name: string, profile?: ProviderSettings, activate?: boolean): Promise<string>
+	updateProfile(name: string, profile: ProviderSettings, activate?: boolean): Promise<string | undefined>
+	upsertProfile(name: string, profile: ProviderSettings, activate?: boolean): Promise<string | undefined>
+	deleteProfile(name: string): Promise<void>
+	getActiveProfile(): string | undefined
+	setActiveProfile(name: string): Promise<string | undefined>
+}
+
 /**
  * Global MCP API instance that will be set by the extension
  */
diff --git a/src/extension/api.ts b/src/extension/api.ts
index 5601a9453a..6d97020eaf 100644
--- a/src/extension/api.ts
+++ b/src/extension/api.ts
@@ -8,6 +8,7 @@ import * as vscode from "vscode"
 import {
 	type RooCodeSettings,
 	type RooCodeEvents,
+	type RooCodeAPI,
 	type ProviderSettings,
 	type ProviderSettingsEntry,
 	type TaskEvent,
@@ -26,7 +27,7 @@ import { Package } from "../shared/package"
 import { ClineProvider } from "../core/webview/ClineProvider"
 import { openClineInNewTab } from "../activate/registerCommands"
 
-export class API extends EventEmitter<RooCodeEvents> implements McpApi {
+export class API extends EventEmitter<RooCodeEvents> implements RooCodeAPI {
 	private readonly outputChannel: vscode.OutputChannel
 	private readonly sidebarProvider: ClineProvider
 	private readonly context: vscode.ExtensionContext