Skip to content

PlanExe MCP Tools - Experimental

MCP is work-in-progress, and I (Simon Strandgaard, the developer) may change it as I see fit. If there is a particular tool you want. Write to me on the PlanExe Discord, and I will see what I can do.

This document lists the MCP tools exposed by PlanExe and example prompts for agents.

Overview

  • The primary MCP server runs in the cloud (see mcp_cloud).
  • The local MCP proxy (mcp_local) forwards calls to the server and adds a local download helper.
  • Tool responses return JSON in both content.text and structuredContent.

Tool Catalog, mcp_cloud

task_create

Create a new plan task.

Example prompt: 

Create a plan for: Weekly meetup for humans where participants are randomly paired every 5 minutes...

Example call: 

{"idea": "Weekly meetup for humans where participants are randomly paired every 5 minutes..."}

Optional argument: 

speed_vs_detail: "ping" | "fast" | "all"

task_status

Fetch status/progress and recent files for a task.

Example prompt: 

Get status for task 2d57a448-1b09-45aa-ad37-e69891ff6ec7.

Example call: 

{"task_id": "2d57a448-1b09-45aa-ad37-e69891ff6ec7"}

task_stop

Request an active task to stop.

Example prompt: 

Stop task 2d57a448-1b09-45aa-ad37-e69891ff6ec7.

Example call: 

{"task_id": "2d57a448-1b09-45aa-ad37-e69891ff6ec7"}

task_file_info

Return download metadata for report or zip artifacts.

Example prompt: 

Get report info for task 2d57a448-1b09-45aa-ad37-e69891ff6ec7.

Example call: 

{"task_id": "2d57a448-1b09-45aa-ad37-e69891ff6ec7", "artifact": "report"}

Available artifacts: 

"report" | "zip"

Tool Catalog, mcp_local

The local proxy exposes the same tools as the server, and adds:

task_download

Download report or zip to a local path.

Example prompt: 

Download the report for task 2d57a448-1b09-45aa-ad37-e69891ff6ec7.

Example call: 

{"task_id": "2d57a448-1b09-45aa-ad37-e69891ff6ec7", "artifact": "report"}

Typical Flow

1) Create a plan

Prompt: 

Create a plan for this idea: Weekly meetup for humans where participants are randomly paired every 5 minutes...

2) Get status

Prompt: 

Get status for my latest task.

Tool call: 

{"task_id": "<task_id_from_task_create>"}

3) Download the report

Prompt: 

Download the report for my task.

Tool call: 

{"task_id": "<task_id_from_task_create>", "artifact": "report"}