Monoplan developer documentation

Monoplan publishes read-only product information for developers and AI agents: plans, integrations and guides.

The public endpoints on this page never return customer workspace data such as employees or schedules.

Authentication

The REST API and the public MCP server need no authentication, API key or account, and are read-only.

REST API

Base URL: https://monoplan.io/api/v1

The OpenAPI specification describes each data endpoint and its responses.

Endpoint	Returns	Parameters
`GET /api/v1/plans`	Plans and prices	`locale`
`GET /api/v1/integrations`	Payroll and point-of-sale integrations	`locale`, `category`
`GET /api/v1/guides`	Workforce-planning guides	`locale`, `query`, `limit`

locale is en (default) or da.

Example requests

curl "https://monoplan.io/api/v1/plans?locale=en"
curl "https://monoplan.io/api/v1/integrations?category=payroll"
curl "https://monoplan.io/api/v1/guides?query=break%20rules&limit=3"

Example response

{
  "guides": [
    {
      "title": "Break rules at work in Denmark",
      "url": "https://monoplan.io/guides/break-rules-at-work-in-denmark"
    }
  ]
}

Rate limits

The REST API and the public MCP server allow about 60 requests per minute per IP address, applied per Cloudflare location. Responses carry RateLimit-Limit and RateLimit-Policy headers. Above the limit you get HTTP 429 with a Retry-After header in seconds.

Versioning and deprecation

The API version is part of the URL. Within v1 we only add fields and endpoints. Breaking changes ship in a new version.

A deprecated version or endpoint keeps working for at least 90 days after it is announced on this page. Its responses carry Deprecation and Sunset headers during that period.

Errors

Invalid parameters return HTTP 400:

{ "error": { "code": "invalid_parameter", "message": "locale must be \"en\" or \"da\"" } }

MCP server

Connect a Model Context Protocol client that supports Streamable HTTP to https://monoplan.io/mcp. No sign-in is needed.

Tool	Purpose
`get_pricing_plans`	Current plans and prices
`list_integrations`	Payroll and point-of-sale integrations
`search_guides`	Search workforce-planning guides

claude mcp add --transport http monoplan https://monoplan.io/mcp

Customer MCP connection

Customers can connect their own AI agent to their workspace at https://app.monoplan.io/mcp. It is separate from the public server above.

Sign in with OAuth using your own Monoplan account. The agent gets your existing permissions and can change the schedule and other data directly.
An administrator turns it on in settings. It requires access to Viggo.
Data the agent reads is sent to the AI provider you connect.

Connect in Claude

In Claude, open Settings → Connectors and choose Add custom connector.
Enter https://app.monoplan.io/mcp as the URL.
Choose Connect and sign in with your Monoplan account.

On Claude Team and Enterprise plans, an owner adds the connector for the organization, and members then connect and sign in.

Other clients that support Streamable HTTP and OAuth connect to the same URL. With Claude Code, add the server and then run /mcp in Claude Code to sign in:

claude mcp add --transport http monoplan-workspace https://app.monoplan.io/mcp

Tools

The tool list only shows the tools your permissions allow. Read tools never change data. Write tools change data at once. They are marked as destructive so your client can ask for your approval before it runs them.

Area	Read	Write
Workspaces	`list_organizations`
Schedule	`list_shifts`, `get_coverage`, `get_planning_rules`, `list_reference_data`, `list_employees`	`create_shifts`, `update_shifts`, `delete_shifts`
Employees	`get_employees`	`create_employees`, `update_employees`, `deactivate_employees`, `reactivate_employees`, `invite_members`
Hours	`get_hours`
Agent changes	`list_recent_agent_changes`	`undo_agent_change`
Settings and other app operations	`list_app_operations`, `read_app_operation`	`write_app_operation`

list_app_operations lists the operations your role can run, with their arguments. Run a read operation with read_app_operation and a write operation with write_app_operation.

Other formats

Send Accept: text/markdown to the homepage, pricing, integrations or this page for Markdown.
Every feature by plan and integration status are also available as Markdown files.
llms.txt gives an overview of the website.

Support

Write to support@monoplan.dk.