Skip to main content
Glama

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

Claude Code CLI

claude mcp add jpi \
  --transport stdio \
  --env JPI_API_TOKEN=your-api-token-here \
  --scope user \
  -- npx -y jpi-mcp

Claude 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-mcp

Windows PowerShell:

$env:JPI_API_TOKEN="your-token"; npx -y jpi-mcp

Windows CMD:

set JPI_API_TOKEN=your-token && npx -y jpi-mcp

Environment Variables

Variable

Required

Default

Description

JPI_API_TOKEN

Yes

-

Your JPI API token

JPI_BASE_URL

No

https://api.just-plan-it.com

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.json

Key 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

ProductionTimePerUnit

seconds

3600 = 1 hour

SetupTime

seconds

900 = 15 minutes

TeardownTime

seconds

600 = 10 minutes

TransferTime

seconds

300 = 5 minutes

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

jpi_api_info

Get API information and available endpoints

Components (9 tools)

Tool

Description

jpi_list_components

List all components

jpi_create_component

Create a new component

jpi_get_component

Get a component by GUID

jpi_update_component

Update a component

jpi_delete_component

Delete a component

jpi_get_component_task

Get a component task

jpi_add_component_task

Add a task to a component

jpi_update_component_task

Update a component task

jpi_delete_component_task

Delete a component task

Jobs (27 tools)

Tool

Description

jpi_list_jobs

List all jobs

jpi_list_jobs_summary

List jobs without task details (~80% smaller)

jpi_list_jobs_at_risk

List jobs at risk of missing due dates

jpi_create_job

Create a new job with tasks

jpi_get_job

Get a job by GUID

jpi_update_job

Update a job

jpi_delete_job

Delete a job

jpi_get_task

Get a job task

jpi_add_task

Add a task to a job

jpi_update_task

Update a job task

jpi_delete_task

Delete a job task

jpi_get_jcr

Get a Job Component Reference

jpi_add_jcr

Add a JCR to a job

jpi_update_jcr

Update a JCR

jpi_delete_jcr

Delete a JCR

jpi_create_jobs_batch

Create multiple jobs

jpi_update_jobs_batch

Update multiple jobs

jpi_delete_jobs_batch

Delete multiple jobs

jpi_add_tasks_batch

Add multiple tasks to a job

jpi_update_tasks_batch

Update multiple tasks

jpi_delete_tasks_batch

Delete multiple tasks

jpi_add_jcrs_batch

Add multiple JCRs

jpi_update_jcrs_batch

Update multiple JCRs

jpi_delete_jcrs_batch

Delete multiple JCRs

jpi_create_tasks_cross_jobs

Create tasks across multiple jobs

jpi_update_tasks_cross_jobs

Update tasks across multiple jobs

jpi_delete_tasks_cross_jobs

Delete tasks across multiple jobs

Job Templates (13 tools)

Tool

Description

jpi_list_templates

List all templates

jpi_create_template

Create a new template

jpi_get_template

Get a template by GUID

jpi_update_template

Update a template

jpi_delete_template

Delete a template

jpi_get_template_task

Get a template task

jpi_add_template_task

Add a task to a template

jpi_update_template_task

Update a template task

jpi_delete_template_task

Delete a template task

jpi_get_tcr

Get a Template Component Reference

jpi_add_tcr

Add a TCR to a template

jpi_update_tcr

Update a TCR

jpi_delete_tcr

Delete a TCR

JPI Events (2 tools)

Tool

Description

jpi_get_events

Get events (change log) after a timestamp

jpi_get_events_filtered

Get events filtered by type

Resource Categories (5 tools)

Tool

Description

jpi_list_resource_categories

List all categories

jpi_create_resource_category

Create a category

jpi_get_resource_category

Get a category

jpi_update_resource_category

Update a category

jpi_delete_resource_category

Delete a category

Resource Groups (5 tools)

Tool

Description

jpi_list_resource_groups

List all groups

jpi_create_resource_group

Create a group

jpi_get_resource_group

Get a group

jpi_update_resource_group

Update a group

jpi_delete_resource_group

Delete a group

Resources (5 tools)

Tool

Description

jpi_list_resources

List all resources

jpi_create_resource

Create a resource

jpi_get_resource

Get a resource

jpi_update_resource

Update a resource

jpi_delete_resource

Delete a resource

Settings (2 tools)

Tool

Description

jpi_get_settings

Get application settings

jpi_update_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

Quoted

Job is quoted but not ordered

Ordered

Job is ordered but not released

Released

Job is released for production

Standby

Job is on standby

Strategy

Value

Description

Asap

Schedule as soon as possible

Jit

Just-in-time scheduling

ASAP_PLUS

ASAP with buffer

JIT_PLUS

JIT with buffer

TaskStatus

Value

Description

Planned

Task is planned

Started

Task has started

Finished

Task is complete

None

No status

Standby

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 build

Watch Mode

npm run dev

Run Locally

JPI_API_TOKEN=your-token npm start

From Source

git clone https://github.com/anthropics/jpi-mcp.git
cd jpi-mcp
npm install
npm run build
npm start

API 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 tools
jpi_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

    B3.2/5.0

    Scored across 69 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    Related MCP Servers