MCP Server

MCP Server

MCP Server

MCP Server

MCP is an open protocol that empowers applications to integrate context into large language models (LLMs) and build powerful, data-driven workflows. By connecting LLMs to external tools and data sources, MCP enables more accurate outputs, deeper insights and more dynamic interactions.

This MCP server connects directly to the Planhat API, offering three core tools to explore, inspect, and operate on Planhat data models in real time.

MCP is an open protocol that empowers applications to integrate context into large language models (LLMs) and build powerful, data-driven workflows. By connecting LLMs to external tools and data sources, MCP enables more accurate outputs, deeper insights and more dynamic interactions.

This MCP server connects directly to the Planhat API, offering three core tools to explore, inspect, and operate on Planhat data models in real time.

MCP is an open protocol that empowers applications to integrate context into large language models (LLMs) and build powerful, data-driven workflows. By connecting LLMs to external tools and data sources, MCP enables more accurate outputs, deeper insights and more dynamic interactions.

This MCP server connects directly to the Planhat API, offering three core tools to explore, inspect, and operate on Planhat data models in real time.

Discover models and operations

Discover available Planhat data models and their supported operations for API exploration and dynamic tool configuraiton. The output is a JSON arary of model routes with supported operations.


Get model parameter schema

Retrieve detailed parameter schemas for specific model-operation combinations, for schema validation, form generation and parameter discovery. Output is JSON schema with parameter definitions, types and requirementst. Use following as input:

  • MODEL_ROUTE : Target data model (E.g. Companies)

  • OPERATION: Desired operation ("create"/"update"/"view"/"list")


Perform operations

Execute CRUD (Create/Read/Update/Delete) operations on Planhat data, for all types of data manipulation. Output is API response, use the following as input:

  • MODEL_ROUTE: Target data model

  • OPERATION: Operation type

  • PARAMETERS: JSON string containing operation data


Discover models and operations

Discover available Planhat data models and their supported operations for API exploration and dynamic tool configuraiton. The output is a JSON arary of model routes with supported operations.


Get model parameter schema

Retrieve detailed parameter schemas for specific model-operation combinations, for schema validation, form generation and parameter discovery. Output is JSON schema with parameter definitions, types and requirementst. Use following as input:

  • MODEL_ROUTE : Target data model (E.g. Companies)

  • OPERATION: Desired operation ("create"/"update"/"view"/"list")


Perform operations

Execute CRUD (Create/Read/Update/Delete) operations on Planhat data, for all types of data manipulation. Output is API response, use the following as input:

  • MODEL_ROUTE: Target data model

  • OPERATION: Operation type

  • PARAMETERS: JSON string containing operation data


Discover models and operations

Discover available Planhat data models and their supported operations for API exploration and dynamic tool configuraiton. The output is a JSON arary of model routes with supported operations.


Get model parameter schema

Retrieve detailed parameter schemas for specific model-operation combinations, for schema validation, form generation and parameter discovery. Output is JSON schema with parameter definitions, types and requirementst. Use following as input:

  • MODEL_ROUTE : Target data model (E.g. Companies)

  • OPERATION: Desired operation ("create"/"update"/"view"/"list")


Perform operations

Execute CRUD (Create/Read/Update/Delete) operations on Planhat data, for all types of data manipulation. Output is API response, use the following as input:

  • MODEL_ROUTE: Target data model

  • OPERATION: Operation type

  • PARAMETERS: JSON string containing operation data


Access token

1. Go to App Center and create a new private app.

2. Assign the necessary permissions to the app based on your access needs.

3. Generate an access token and use it to authenticate MCP requests.


Example Request



Access token

1. Go to App Center and create a new private app.

2. Assign the necessary permissions to the app based on your access needs.

3. Generate an access token and use it to authenticate MCP requests.


Example Request



Access token

1. Go to App Center and create a new private app.

2. Assign the necessary permissions to the app based on your access needs.

3. Generate an access token and use it to authenticate MCP requests.


Example Request



401 Unauthorized

Caused by missing or invalid access token. Check the Authorization: Bearer <token>/<token> and ensure token is active and valid.

403 Forbidden

Caused by token lacking permissions. Solve by updating app permissions in App Center.

404 Not Found

Caused by invalid MODEL_ROUTE or OPERATION. Fix by confirming supported models/operations using get_model_actions.

400 Bad Request

Caused by missing or invalid parameters. Ensure correct types and required fields are correct by checking get_model_action_parameters.

429 Too Many Requests

Rate limit hit. Retry with delay, use Retry-After header if present

500 Internal Server Error

Unexpected server-side issue. Retry the request, report to Planhat Team with request details if persistent.


401 Unauthorized

Caused by missing or invalid access token. Check the Authorization: Bearer <token>/<token> and ensure token is active and valid.

403 Forbidden

Caused by token lacking permissions. Solve by updating app permissions in App Center.

404 Not Found

Caused by invalid MODEL_ROUTE or OPERATION. Fix by confirming supported models/operations using get_model_actions.

400 Bad Request

Caused by missing or invalid parameters. Ensure correct types and required fields are correct by checking get_model_action_parameters.

429 Too Many Requests

Rate limit hit. Retry with delay, use Retry-After header if present

500 Internal Server Error

Unexpected server-side issue. Retry the request, report to Planhat Team with request details if persistent.


401 Unauthorized

Caused by missing or invalid access token. Check the Authorization: Bearer <token>/<token> and ensure token is active and valid.

403 Forbidden

Caused by token lacking permissions. Solve by updating app permissions in App Center.

404 Not Found

Caused by invalid MODEL_ROUTE or OPERATION. Fix by confirming supported models/operations using get_model_actions.

400 Bad Request

Caused by missing or invalid parameters. Ensure correct types and required fields are correct by checking get_model_action_parameters.

429 Too Many Requests

Rate limit hit. Retry with delay, use Retry-After header if present

500 Internal Server Error

Unexpected server-side issue. Retry the request, report to Planhat Team with request details if persistent.