JPI MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@JPI MCP Server list all jobs at risk of missing their due dates"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
JPI MCP Server
Model Context Protocol (MCP) server for Just Plan It (JPI) API integration. This server enables AI assistants to interact with the JPI job scheduling and resource management system.
Features
69 MCP Tools covering all JPI API endpoints
Full CRUD operations for all JPI entities
Batch operations for efficient bulk updates
Cross-job task operations
Type-safe TypeScript implementation
Comprehensive error handling
Related MCP server: Personal Task Manager MCP
Quick Start
Prerequisites
Node.js 18+
A JPI API token (get from Just Plan It)
Claude Code CLI
claude mcp add jpi \
--transport stdio \
--env JPI_API_TOKEN=your-api-token-here \
--scope user \
-- npx -y jpi-mcpClaude Desktop
Add to your Claude Desktop configuration file:
{
"mcpServers": {
"jpi": {
"command": "npx",
"args": ["-y", "jpi-mcp"],
"env": {
"JPI_API_TOKEN": "your-api-token-here"
}
}
}
}Direct CLI Usage
For other CLI tools or direct shell usage:
Unix/macOS/Linux:
JPI_API_TOKEN=your-token npx -y jpi-mcpWindows PowerShell:
$env:JPI_API_TOKEN="your-token"; npx -y jpi-mcpWindows CMD:
set JPI_API_TOKEN=your-token && npx -y jpi-mcpEnvironment Variables
Variable | Required | Default | Description |
| Yes | - | Your JPI API token |
| No |
| JPI API base URL |
Architecture
jpi-mcp/
├── src/
│ ├── index.ts # MCP server setup, 69 tool definitions, request handlers
│ ├── client.ts # JpiClient class - HTTP client for JPI API v1
│ └── types/ # TypeScript types matching JPI API schemas
│ ├── index.ts # Re-exports all types
│ ├── enums.ts # OrderStatus, Strategy, TaskStatus, EventType, etc.
│ ├── schemas.ts # Common schemas (Identifier, HyperLink, ResourceGroupConstraint)
│ ├── jobs.ts # Job, Task, JobComponentReference types
│ ├── components.ts # Component, ComponentTask types
│ ├── templates.ts # JobTemplate, TemplateTask, TemplateComponentReference types
│ ├── resources.ts # Resource, ResourceGroup, ResourceCategory types
│ ├── settings.ts # Application settings types
│ └── events.ts # JPI event/change log types
└── package.jsonKey Concepts
Jobs & Tasks
Job: A production order or work order containing one or more tasks
Task: A single operation within a job (e.g., cutting, welding, painting)
Predecessors: Tasks that must complete before a task can start
TaskConnections: Linked tasks for scheduling coordination
Components & References
Component: A reusable template of tasks that can be referenced by jobs
JCR (Job Component Reference): Links a component to a job, creating tasks automatically
TCR (Template Component Reference): Links a component to a job template
Resource Hierarchy
Resource Categories
└── Resource Groups
└── Resources (machines, workers, etc.)Time Units
IMPORTANT: All time fields in the JPI API are in SECONDS, not minutes.
Field | Unit | Example |
| seconds |
|
| seconds |
|
| seconds |
|
| seconds |
|
Field Naming Convention
All API fields use PascalCase to match the JPI API exactly (e.g., DueDate, TaskNo, ResourceGroupConstraints).
Available Tools (69 Total)
Helper (1 tool)
Tool | Description |
| Get API information and available endpoints |
Components (9 tools)
Tool | Description |
| List all components |
| Create a new component |
| Get a component by GUID |
| Update a component |
| Delete a component |
| Get a component task |
| Add a task to a component |
| Update a component task |
| Delete a component task |
Jobs (27 tools)
Tool | Description |
| List all jobs |
| List jobs without task details (~80% smaller) |
| List jobs at risk of missing due dates |
| Create a new job with tasks |
| Get a job by GUID |
| Update a job |
| Delete a job |
| Get a job task |
| Add a task to a job |
| Update a job task |
| Delete a job task |
| Get a Job Component Reference |
| Add a JCR to a job |
| Update a JCR |
| Delete a JCR |
| Create multiple jobs |
| Update multiple jobs |
| Delete multiple jobs |
| Add multiple tasks to a job |
| Update multiple tasks |
| Delete multiple tasks |
| Add multiple JCRs |
| Update multiple JCRs |
| Delete multiple JCRs |
| Create tasks across multiple jobs |
| Update tasks across multiple jobs |
| Delete tasks across multiple jobs |
Job Templates (13 tools)
Tool | Description |
| List all templates |
| Create a new template |
| Get a template by GUID |
| Update a template |
| Delete a template |
| Get a template task |
| Add a task to a template |
| Update a template task |
| Delete a template task |
| Get a Template Component Reference |
| Add a TCR to a template |
| Update a TCR |
| Delete a TCR |
JPI Events (2 tools)
Tool | Description |
| Get events (change log) after a timestamp |
| Get events filtered by type |
Resource Categories (5 tools)
Tool | Description |
| List all categories |
| Create a category |
| Get a category |
| Update a category |
| Delete a category |
Resource Groups (5 tools)
Tool | Description |
| List all groups |
| Create a group |
| Get a group |
| Update a group |
| Delete a group |
Resources (5 tools)
Tool | Description |
| List all resources |
| Create a resource |
| Get a resource |
| Update a resource |
| Delete a resource |
Settings (2 tools)
Tool | Description |
| Get application settings |
| Update settings |
Usage Examples
Create a Job with Tasks
{
"Name": "Production Order 001",
"JobNo": "PO-001",
"DueDate": "2024-12-31T17:00:00",
"ReleaseDate": "2024-12-01T08:00:00",
"Strategy": "Asap",
"OrderStatus": "Released",
"Customer": "ACME Corp",
"Quantity": 100,
"Tasks": [
{
"TaskNo": "T010",
"Name": "Laser Cutting",
"ProductionTimePerUnit": 60,
"SetupTime": 900,
"ResourceGroupConstraints": [
{
"ResourceGroup": "resource-group-guid-here"
}
]
},
{
"TaskNo": "T020",
"Name": "Welding",
"ProductionTimePerUnit": 120,
"PredecessorTaskNos": ["T010"],
"ResourceGroupConstraints": [
{
"ResourceGroup": "welding-group-guid"
}
]
}
]
}Update Task Status
{
"jobGuid": "job-guid-here",
"taskGuid": "task-guid-here",
"TaskStatus": "Started"
}Batch Create Jobs
{
"jobs": [
{ "Name": "Job 1", "Tasks": [...] },
{ "Name": "Job 2", "Tasks": [...] },
{ "Name": "Job 3", "Tasks": [...] }
]
}Enums & Types
OrderStatus
Value | Description |
| Job is quoted but not ordered |
| Job is ordered but not released |
| Job is released for production |
| Job is on standby |
Strategy
Value | Description |
| Schedule as soon as possible |
| Just-in-time scheduling |
| ASAP with buffer |
| JIT with buffer |
TaskStatus
Value | Description |
| Task is planned |
| Task has started |
| Task is complete |
| No status |
| Task is on standby |
Error Handling
All tools return structured error responses:
{
"error": true,
"status": 400,
"statusText": "Bad Request",
"message": "JPI API Error: 400 Bad Request",
"body": {
"details": "Validation failed for field 'Name'"
}
}Development
Build
npm run buildWatch Mode
npm run devRun Locally
JPI_API_TOKEN=your-token npm startFrom Source
git clone https://github.com/anthropics/jpi-mcp.git
cd jpi-mcp
npm install
npm run build
npm startAPI Reference
This MCP server wraps the JPI REST API v1. For detailed API documentation:
License
MIT
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
Available Tools
69 toolsjpi_add_component_taskC
Add a new task to a component.
Inputs: componentGuid (required), TaskNo (required), ResourceGroupConstraints (required), Name, +3 more.
jpi_add_jcrB
Add a Job Component Reference to a job.
Inputs: jobGuid (required), ComponentGuid (required), TaskNo, Quantity, +1 more.
jpi_add_jcrs_batchC
Add multiple Job Component References to a job in a single batch operation.
Inputs: jobGuid (required), jcrs (required).
jpi_add_taskC
Add a new task to a job.
Inputs: jobGuid (required), TaskNo (required), ResourceGroupConstraints (required), Name, +6 more.
jpi_add_tasks_batchC
Add multiple tasks to a job in a single batch operation.
Inputs: jobGuid (required), tasks (required).
jpi_add_tcrC
Add a Template Component Reference to a template.
Inputs: templateGuid (required), ComponentGuid (required), Quantity.
jpi_add_template_taskC
Add a new task to a template.
Inputs: templateGuid (required), TaskNo (required), ResourceGroupConstraints (required), Name, +3 more.
jpi_api_infoA
Get information about the JPI API and available endpoints. Use this to understand what operations are available.
Inputs: no named parameters.
jpi_create_componentC
Create a new component with tasks.
Inputs: Name (required), Tasks.
jpi_create_jobC
Create a new job with tasks and scheduling information.
Inputs: Name (required), Tasks (required), JobNo, DueDate, +5 more.
jpi_create_jobs_batchC
Create multiple jobs in a single batch operation.
Inputs: jobs (required).
jpi_create_resourceC
Create a new resource.
Inputs: Name (required), WorktimesPerWeekday (required), Capacity, Finite, +1 more.
jpi_create_resource_categoryC
Create a new resource category.
Inputs: Name (required).
jpi_create_resource_groupC
Create a new resource group.
Inputs: Name (required), ResourceCategoryGuid, Resources.
jpi_create_tasks_cross_jobsC
Create tasks across multiple jobs in a single batch operation.
Inputs: tasks (required).
jpi_create_templateC
Create a new job template.
Inputs: Name (required), HyperLinks.
jpi_delete_componentC
Delete a component by its GUID.
Inputs: guid (required).
jpi_delete_component_taskC
Delete a task from a component.
Inputs: componentGuid (required), taskGuid (required).
jpi_delete_jcrC
Delete a Job Component Reference.
Inputs: jobGuid (required), jcrGuid (required).
jpi_delete_jcrs_batchC
Delete multiple Job Component References in a single batch operation.
Inputs: jobGuid (required), jcrGuids (required).
jpi_delete_jobC
Delete a job by its GUID.
Inputs: guid (required).
jpi_delete_jobs_batchC
Delete multiple jobs in a single batch operation.
Inputs: guids (required).
jpi_delete_resourceC
Delete a resource by its GUID.
Inputs: guid (required).
jpi_delete_resource_categoryC
Delete a resource category by its GUID.
Inputs: guid (required).
jpi_delete_resource_groupC
Delete a resource group by its GUID.
Inputs: guid (required).
jpi_delete_taskC
Delete a task from a job.
Inputs: jobGuid (required), taskGuid (required).
jpi_delete_tasks_batchC
Delete multiple tasks from a job in a single batch operation.
Inputs: jobGuid (required), taskGuids (required).
jpi_delete_tasks_cross_jobsC
Delete tasks across multiple jobs in a single batch operation.
Inputs: taskGuids (required).
jpi_delete_tcrC
Delete a Template Component Reference.
Inputs: templateGuid (required), tcrGuid (required).
jpi_delete_templateC
Delete a job template by its GUID.
Inputs: guid (required).
jpi_delete_template_taskC
Delete a task from a template.
Inputs: templateGuid (required), taskGuid (required).
jpi_get_componentC
Get a specific component by its GUID.
Inputs: guid (required).
jpi_get_component_taskC
Get a specific task within a component.
Inputs: componentGuid (required), taskGuid (required).
jpi_get_eventsC
Get JPI events (change log) created after a specific timestamp.
Inputs: createdAfter (required).
jpi_get_events_filteredC
Get JPI events filtered by event type.
Inputs: createdAfter (required), eventType (required).
jpi_get_jcrC
Get a Job Component Reference (JCR) - a reference to a component used in a job.
Inputs: jobGuid (required), jcrGuid (required).
jpi_get_jobB
Get a specific job by its GUID.
Inputs: guid (required).
jpi_get_resourceC
Get a specific resource by its GUID.
Inputs: guid (required).
jpi_get_resource_categoryB
Get a specific resource category by its GUID.
Inputs: guid (required).
jpi_get_resource_groupB
Get a specific resource group by its GUID.
Inputs: guid (required).
jpi_get_settingsB
Get the JPI application settings including custom fields, planning configuration, and display options.
Inputs: no named parameters.
jpi_get_taskC
Get a specific task within a job.
Inputs: jobGuid (required), taskGuid (required).
jpi_get_tcrC
Get a Template Component Reference (TCR).
Inputs: templateGuid (required), tcrGuid (required).
jpi_get_templateB
Get a specific job template by its GUID.
Inputs: guid (required).
jpi_get_template_taskC
Get a specific task within a template.
Inputs: templateGuid (required), taskGuid (required).
jpi_list_componentsB
List all components in the JPI system. Components are reusable building blocks that can be referenced by jobs.
Inputs: no named parameters.
jpi_list_jobsA
List all jobs in the JPI system with FULL task details. WARNING: Returns large payload. Use jpi_list_jobs_summary for job overviews or jpi_list_jobs_at_risk for risk analysis.
Inputs: no named parameters.
jpi_list_jobs_at_riskA
List jobs at risk of missing due dates. Returns only jobs where IsDueDateExceeded=true OR BufferLevel < threshold. Minimal fields for maximum token efficiency (~95% smaller than jpi_list_jobs).
Inputs: bufferThreshold.
jpi_list_jobs_summaryA
List all jobs WITHOUT task details. Returns job metadata only (Name, DueDate, PlannedEnd, Status, etc.) with TaskCount. Use this for job overviews to reduce token usage (~80% smaller than jpi_list_jobs).
Inputs: no named parameters.
jpi_list_resource_categoriesB
List all resource categories. Categories group related resource groups.
Inputs: no named parameters.
jpi_list_resource_groupsB
List all resource groups. Groups organize resources that can perform similar work.
Inputs: no named parameters.
jpi_list_resourcesB
List all resources. Resources are machines, workers, or other entities that perform work.
Inputs: no named parameters.
jpi_list_templatesB
List all job templates. Templates are reusable job definitions.
Inputs: no named parameters.
jpi_update_componentC
Update an existing component.
Inputs: guid (required), Name.
jpi_update_component_taskC
Update a task within a component.
Inputs: componentGuid (required), taskGuid (required), Name, ProductionTimePerUnit, +2 more.
jpi_update_jcrC
Update a Job Component Reference.
Inputs: jobGuid (required), jcrGuid (required), TaskNo, Quantity, +1 more.
jpi_update_jcrs_batchC
Update multiple Job Component References in a single batch operation.
Inputs: jobGuid (required), jcrs (required).
jpi_update_jobC
Update an existing job.
Inputs: guid (required), Name, DueDate, ReleaseDate, +4 more.
jpi_update_jobs_batchC
Update multiple jobs in a single batch operation.
Inputs: jobs (required).
jpi_update_resourceC
Update a resource.
Inputs: guid (required), Name, Capacity, Finite, +1 more.
jpi_update_resource_categoryC
Update a resource category.
Inputs: guid (required), Name.
jpi_update_resource_groupC
Update a resource group.
Inputs: guid (required), Name, ResourceCategoryGuid, Resources.
jpi_update_settingsC
Update JPI application settings.
Inputs: PlanningStart, PlanningHorizon, Locale.
jpi_update_taskC
Update a task within a job.
Inputs: jobGuid (required), taskGuid (required), Name, ProductionTimePerUnit, +5 more.
jpi_update_tasks_batchC
Update multiple tasks within a job in a single batch operation.
Inputs: jobGuid (required), tasks (required).
jpi_update_tasks_cross_jobsB
Update tasks across multiple jobs in a single batch operation.
Inputs: tasks (required).
jpi_update_tcrC
Update a Template Component Reference.
Inputs: templateGuid (required), tcrGuid (required), Quantity.
jpi_update_templateC
Update an existing job template.
Inputs: guid (required), Name.
jpi_update_template_taskC
Update a task within a template.
Inputs: templateGuid (required), taskGuid (required), Name, ProductionTimePerUnit, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 69 tools
The tools are well-differentiated by resource type (component, job, template, resource) and action (add, create, delete, get, list, update), with clear boundaries. However, some overlap exists between 'add' and 'create' operations (e.g., jpi_add_task vs. jpi_create_tasks_cross_jobs), which could cause minor confusion, but descriptions help clarify their distinct contexts.
Tool names follow a highly consistent verb_noun pattern with the 'jpi_' prefix throughout. Verbs like add, create, delete, get, list, and update are used predictably, and naming conventions (snake_case) are uniform across all 69 tools, making the set easy to navigate and understand.
With 69 tools, the count is excessive for typical MCP server purposes, leading to potential cognitive overload and inefficiency. While the domain (job planning and integration) is complex, the tool surface could be streamlined by reducing redundancy (e.g., multiple batch operations) without losing functionality.
The tool set provides comprehensive CRUD/lifecycle coverage for all core resources (components, jobs, templates, resources, categories, groups), including batch operations and settings management. No obvious gaps exist; agents can perform full workflows from creation to deletion with detailed querying and updates.
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Discover, plan and run tools across your connected business systems through one OAuth MCP endpoint
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides tools for AI assistants to interact with JIRA APIs, enabling them to read, create, update, and manage JIRA issues through standardized MCP tools.63MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage tasks with full lifecycle support including due dates, priorities, tags, subtasks, and project lists via 19 SQLite-backed MCP tools.5-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage ClickUp workspaces, teams, spaces, folders, lists, tasks, and custom fields via 29 MCP tools with full CRUD operations.5ISC
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage projects, tasks, and schedules in JJ Planner through CRUD operations.5 npm-