Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Pylon MCP connector

OAuth 2.1/DCR Customer SupportProject Management

Connect to Pylon MCP. Manage customer issues, accounts, projects, milestones, and tasks from your AI workflows.

Pylon MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'pylonmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Pylon MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'pylonmcp_get_me',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Files upload account — Upload one or more files to an account
  • Update task, project, milestone — Update a task title, status, assignee, due date, or other fields by its ID
  • Search tasks, projects, issues — Search tasks by text, project, account, assignee, and status
  • Get user, tasks, task — Retrieve a single user by their ID or email
  • Delete task — Permanently delete a task by its ID
  • Create task, project from template, project — Create a new task with a title

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

pylonmcp_create_issue # Create a new issue in Pylon with a title, body, and account. Optionally assign a requester, priority, team, and tags. 8 params

Create a new issue in Pylon with a title, body, and account. Optionally assign a requester, priority, team, and tags.

Name Type Required Description
account_id string required ID of the account to associate with this resource.
body_html string required The HTML content of the body of the issue. Required.
title string required The title of the issue. Required.
assignee_id string optional ID of the user to assign this resource to.
priority string optional The priority of the issue.
requester_id string optional The ID of the requester (contact) that this issue is on behalf of.
tags array optional An array of tags to set on the issue.
team_id string optional The ID of the team to assign the issue to.
pylonmcp_create_milestone # Create a milestone within a project. Optionally set a due date and account. 4 params

Create a milestone within a project. Optionally set a due date and account.

Name Type Required Description
name string required Milestone name.
project_id string required Project ID for this milestone.
account_id string optional ID of the account to associate with this resource.
due_date string optional Due date in RFC3339 format.
pylonmcp_create_project # Create a project for an account. Provide a name or a project_template_id to scaffold milestones and tasks from a template. 10 params

Create a project for an account. Provide a name or a project_template_id to scaffold milestones and tasks from a template.

Name Type Required Description
account_id string required ID of the account to associate with this resource.
customer_portal_visible boolean optional Whether this project is visible in the customer portal.
description_html string optional Project description as HTML.
end_date string optional End date in RFC3339 format.
name string optional Project name. Required unless project_template_id is provided.
owner_id string optional ID of the user who owns this resource.
owner_type string optional Owner type. Defaults to user when owner_id is provided.
project_template_id string optional Project template ID to scaffold tasks, milestones, and subtasks from.
start_date string optional Start date in RFC3339 format.
status string optional Project status.
pylonmcp_create_project_from_template # Create a project from a template, copying its milestones, tasks, and subtasks. Optionally override name, dates, owner, and status. 9 params

Create a project from a template, copying its milestones, tasks, and subtasks. Optionally override name, dates, owner, and status.

Name Type Required Description
account_id string required ID of the account to associate with this resource.
project_template_id string required Project template ID to use.
customer_portal_visible boolean optional Optional customer portal visibility override.
description_html string optional Optional project description override as HTML.
end_date string optional Optional end date override in RFC3339 format.
name string optional Optional project name override.
owner_id string optional ID of the user who owns this resource.
start_date string optional Optional start date override in RFC3339 format.
status string optional Optional project status override.
pylonmcp_create_task # Create a new task with a title. Optionally link it to an account, project, milestone, or parent task. 10 params

Create a new task with a title. Optionally link it to an account, project, milestone, or parent task.

Name Type Required Description
title string required The title of the task. Required.
account_id string optional ID of the account to associate with this resource.
assignee_id string optional ID of the user to assign this resource to.
body_html string optional The body HTML content of the task.
customer_portal_visible boolean optional Whether the task is visible in the customer portal.
due_date string optional The due date for the task in RFC3339 format.
milestone_id string optional The ID of the milestone that this task belongs to.
parent_task_id string optional The ID of the parent task, to create this as a subtask.
project_id string optional The ID of the project that this task belongs to.
status string optional The status of the task.
pylonmcp_delete_task # Permanently delete a task by its ID. 1 param

Permanently delete a task by its ID.

Name Type Required Description
task_id string required The ID of the task to delete. Required.
pylonmcp_get_account # Retrieve a single account by its ID or external ID. 1 param

Retrieve a single account by its ID or external ID.

Name Type Required Description
account string required The account ID (UUID) or external ID.
pylonmcp_get_contact # Retrieve a single contact by their ID or external ID. 1 param

Retrieve a single contact by their ID or external ID.

Name Type Required Description
contact string required The contact ID (UUID).
pylonmcp_get_issue # Retrieve a single issue by its ID. 1 param

Retrieve a single issue by its ID.

Name Type Required Description
issue string required The issue ID (UUID) or issue number.
pylonmcp_get_issue_messages # Retrieve all messages and replies for a specific issue. 1 param

Retrieve all messages and replies for a specific issue.

Name Type Required Description
issue string required The issue ID (UUID) or issue number.
pylonmcp_get_me # Retrieve the profile of the currently authenticated user. 0 params

Retrieve the profile of the currently authenticated user.

pylonmcp_get_milestone # Retrieve a single milestone by its ID. 1 param

Retrieve a single milestone by its ID.

Name Type Required Description
milestone_id string required The milestone ID to get details for.
pylonmcp_get_milestones # List milestones, optionally filtered by project or account. 3 params

List milestones, optionally filtered by project or account.

Name Type Required Description
account_id string optional ID of the account to associate with this resource.
limit integer optional Maximum number of items to return.
project_id string optional Project ID to filter milestones by.
pylonmcp_get_project # Retrieve a single project by its ID. 1 param

Retrieve a single project by its ID.

Name Type Required Description
project_id string required The project ID to get details for. Required.
pylonmcp_get_project_templates # List available project templates, optionally filtered by name. 2 params

List available project templates, optionally filtered by name.

Name Type Required Description
limit integer optional Maximum number of items to return.
name string optional Optional case-insensitive template name filter.
pylonmcp_get_projects # List projects, optionally filtered by account and archived status. 3 params

List projects, optionally filtered by account and archived status.

Name Type Required Description
account_id string optional ID of the account to associate with this resource.
include_archived boolean optional Whether to include archived projects. Defaults to false.
limit integer optional Maximum number of items to return.
pylonmcp_get_task # Retrieve a single task by its ID. 1 param

Retrieve a single task by its ID.

Name Type Required Description
task_id string required The task ID to get details for. Required.
pylonmcp_get_tasks # List tasks, optionally filtered by project, account, and status. 4 params

List tasks, optionally filtered by project, account, and status.

Name Type Required Description
account_id string optional ID of the account to associate with this resource.
limit integer optional Maximum number of items to return.
project_id string optional The project ID to filter tasks by.
statuses array optional Filter by task statuses.
pylonmcp_get_user # Retrieve a single user by their ID or email. 1 param

Retrieve a single user by their ID or email.

Name Type Required Description
user string required The user ID (UUID).
pylonmcp_search_accounts # Search accounts by name, domain, owner, tags, or custom field filters. 8 params

Search accounts by name, domain, owner, tags, or custom field filters.

Name Type Required Description
cursor string optional Pagination cursor from the previous response to fetch the next page.
custom_field_filters array optional Filter by custom fields. Each filter specifies a custom field slug, operator, and value(s). For user-type fields, pass a Pylon user name or ID as the value - names will be resolved to Pylon user IDs automatically.
domain string optional Filter by domain (accounts containing this domain).
external_id string optional Filter by external ID.
limit integer optional Maximum number of items to return.
name string optional Filter by account name (partial match).
owner string optional Filter by account owner. Accepts a user ID or name (partial match).
tags array optional Filter by tags. Returns accounts containing any of the specified tags.
pylonmcp_search_issues # Search issues by account, assignee, state, tags, type, and date range. 14 params

Search issues by account, assignee, state, tags, type, and date range.

Name Type Required Description
account string optional Filter by account. Accepts either an account ID or a name (partial match).
assignee string optional Filter by assignee. Accepts either a user ID or a name (partial match).
created_after string optional Filter for issues created after this time (RFC3339 format).
created_before string optional Filter for issues created before this time (RFC3339 format).
cursor string optional Pagination cursor from the previous response to fetch the next page.
custom_field_filters array optional Filter by custom fields. Each filter specifies a custom field slug, operator, and value(s). For user-type fields, pass a Pylon user name or ID as the value - names will be resolved to Pylon user IDs automatically.
is_issue_group boolean optional Filter by whether the issue is an issue group. Pass true to get only issue groups, false to exclude them.
limit integer optional Maximum number of items to return.
requester string optional Filter by requester. Accepts either a contact ID or a name (partial match).
states array optional Filter by issue states (inclusion). Accepts built-in slugs (new, waiting_on_you, waiting_on_customer, on_hold, closed) and custom state slugs.
states_not_in array optional Exclude issues in these states. Accepts built-in slugs (new, waiting_on_you, waiting_on_customer, on_hold, closed) and custom state slugs.
tags array optional Filter by tags. Returns issues containing any of the specified tags.
team_id string optional Filter by team ID. Returns issues assigned to the specified team.
type string optional Filter by issue type.
pylonmcp_search_projects # Search projects by text, account, owner, status, and archived state. 6 params

Search projects by text, account, owner, status, and archived state.

Name Type Required Description
account_id string optional ID of the account to associate with this resource.
include_archived boolean optional Whether to include archived projects. Defaults to false.
limit integer optional Maximum number of items to return.
owner_id string optional ID of the user who owns this resource.
search_text string optional Search text for project names.
statuses array optional Filter by project statuses.
pylonmcp_search_tasks # Search tasks by text, project, account, assignee, and status. 6 params

Search tasks by text, project, account, assignee, and status.

Name Type Required Description
account_id string optional ID of the account to associate with this resource.
assignee_id string optional ID of the user to assign this resource to.
limit integer optional Maximum number of items to return.
project_id string optional The project ID to filter tasks by.
search_text string optional Search text for full-text search across task titles.
statuses array optional Filter by task statuses.
pylonmcp_update_account # Update an account name, owner, tags, or custom fields by its ID. 5 params

Update an account name, owner, tags, or custom fields by its ID.

Name Type Required Description
account_id string required ID of the account to associate with this resource.
custom_fields object optional Custom field values to set. Keys are custom field slugs (use get_custom_fields with object_type 'account' to discover available slugs), values are the field values to set. For multi-select fields, use comma-separated values.
name string optional The new name for the account.
owner_id string optional ID of the user who owns this resource.
tags array optional An array of tags to set on the account. This replaces all existing tags.
pylonmcp_update_issue # Update an issue state, assignee, team, or tags by its ID. 5 params

Update an issue state, assignee, team, or tags by its ID.

Name Type Required Description
issue_id string required The ID or number of the issue to update. Required.
assignee_id string optional ID of the user to assign this resource to.
state string optional The state to set the issue to. Standard values: new, waiting_on_you, waiting_on_customer, on_hold, closed. Custom status slugs are also accepted.
tags array optional An array of tags to set on the issue. This replaces all existing tags.
team_id string optional The ID of the team to assign the issue to. Pass empty string to remove team assignment.
pylonmcp_update_milestone # Update a milestone name or due date by its ID. 3 params

Update a milestone name or due date by its ID.

Name Type Required Description
milestone_id string required The milestone ID to update.
due_date string optional Due date in RFC3339 format. Pass empty string to clear.
name string optional Milestone name.
pylonmcp_update_project # Update project details such as name, status, dates, owner, and visibility by its ID. 9 params

Update project details such as name, status, dates, owner, and visibility by its ID.

Name Type Required Description
project_id string required The project ID to update.
customer_portal_visible boolean optional Whether this project is visible in the customer portal.
description_html string optional Project description as HTML.
end_date string optional End date in RFC3339 format. Pass empty string to clear.
is_archived boolean optional Whether this project is archived.
name string optional Project name.
owner_id string optional ID of the user who owns this resource.
start_date string optional Start date in RFC3339 format. Pass empty string to clear.
status string optional Project status.
pylonmcp_update_task # Update a task title, status, assignee, due date, or other fields by its ID. 10 params

Update a task title, status, assignee, due date, or other fields by its ID.

Name Type Required Description
task_id string required The ID of the task to update. Required.
account_id string optional ID of the account to associate with this resource.
assignee_id string optional ID of the user to assign this resource to.
body_html string optional The body HTML content of the task.
customer_portal_visible boolean optional Whether the task is visible in the customer portal.
due_date string optional The due date for the task in RFC3339 format. Pass empty string to clear.
milestone_id string optional The ID of the milestone. Pass empty string to clear.
project_id string optional The ID of the project. Pass empty string to clear.
status string optional The status of the task.
title string optional The title of the task.
pylonmcp_upload_account_files # Upload one or more files to an account. Each file requires a filename and base64-encoded content. 2 params

Upload one or more files to an account. Each file requires a filename and base64-encoded content.

Name Type Required Description
account_id string required ID of the account to associate with this resource.
files array required Files to upload. 1 to 5 files per call.