TWP MCP Server
This is a Model Context Protocol (MCP) server for TWP (Tocca Working Platform).
Endpoints
| Endpoint | Description | Tools |
|---|---|---|
/api/mcp | TWP core tools (projects, tasks, task links, comments, attachments, statuses, notifications, users, master data) | 39 |
/api/mcp/report | Report management tools | 12 |
/api/mcp/file | File management tools (upload, download, folders, publish, trash, AI generation and remix) | 63 |
/api/mcp/note | Note (knowledge base) tools | 14 |
/api/mcp/hearing | Hearing (interview) tools | 5 |
/api/mcp/sales | Sales trading tools (estimates, contracts, invoices, deposits) with read-only master data | 27 |
/api/mcp/prospect | Prospect (見込客) tools: search / get / create / bulk create / update / delete, with read-only campaign master (interaction history: use list/create_customer_interaction with prospect_id on /api/mcp/customer) | 7 |
/api/mcp/customer | Customer management tools (顧客企業 / 人物・担当者 / 対応履歴): list / get / create / update | 12 |
/api/mcp/attendance | Attendance tools (自分の勤怠, read only): your own daily clock-in/out and work time per project — for drafting daily reports | 2 |
/api/mcp/budget | Budget tools (予実管理): get / replace the department allocation settings (部署按分設定) of a project, and get / bulk-set / copy-from-previous-year the monthly sales and profit targets (目標) | 5 |
/api/mcp/staffing-board | Staffing board tools (要員調整ボード, read only): board table, settings, tentative assignments, notes, snapshots / diff, and cell edit history | 8 |
/api/mcp/support | Support request tools (依頼者側): list categories / list / get / create / update / comment / withdraw / close / reinquire | 10 |
/api/mcp/personal | Personal integrations (Backlog, Microsoft 365) | 48 |
/api/mcp/worker-agent | Worker agent tools (create / configure / run / monitor scheduled autonomous agents) and container agent schedules (read only) | 18 |
/api/mcp/project-master | Project master tools (工程 / 品質チェック項目, tenant-wide): list / get / create / update. No delete | 8 |
/api/mcp/knowledge/[slug] | Domain knowledge base (read only) for the knowledge base in the URL: manifest / list / read / search. Public access is not available yet; use /api/mcp/knowledge-auth/[slug] | 4 |
/api/mcp/knowledge-auth/[slug] | Domain knowledge base (read only, authenticated) for the knowledge base in the URL: manifest / list / read / search | 4 |
/api/mcp/knowledge-admin | Domain knowledge base admin tools (knowledge base admins only): create / update / delete / move draft documents and publish | 4 |
All endpoints use Streamable HTTP transport.
Tools — /api/mcp (39)
- list_projects — List projects with optional filtering and pagination.
- get_project — Get project details by ID
- create_project — Create a new project
- update_project — Update an existing project
- list_tasks — List tasks in a project with optional filtering and pagination.
- get_task — Get task details by ID or task key.
- create_task — Create a new task in a project.
- update_task — Update an existing task.
- delete_task — Delete a task.
- list_task_links — List links of a project task.
- create_task_link — Link two tasks.
- update_task_link — Change the prerequisite condition (satisfied_status_ids) of a blocks / blocked_by link.
- delete_task_link — Remove the link between two tasks (both directions).
- list_comments — List comments on a task.
- create_comment — Add a comment to a task.
- update_comment — Update an existing comment
- delete_comment — Delete a comment
- list_task_attachments — List attachments on a task.
- get_task_attachment — Get attachment metadata by ID
- generate_upload_url — Generate a pre-signed S3 upload URL for a file.
- commit_task_attachment — Commit an uploaded file to a task.
- get_download_url — Get a pre-signed S3 download URL for an attachment
- explain_attachment — Get an AI-generated explanation of an attachment's content.
- delete_task_attachment — Delete an attachment from a task
- list_statuses — List project task statuses.
- list_notifications — List notifications for the authenticated user.
- get_notification — Get notification details by ID
- get_notification_counts — Get unread and unreacted notification counts
- mark_notification_read — Mark a specific notification as read
- mark_all_notifications_read — Mark all unread notifications as read
- list_users — List members of a project who can be assigned to tasks (project_id required; keyword searches name or email).
- list_types — List task types for a project.
- list_categories — List task categories for a project.
- list_task_groups — List task groups for a project (TWP-7228).
- create_task_group — Create a task group in a project (TWP-7345).
- update_task_group — Update a task group (TWP-7345).
- delete_task_group — Delete a task group (TWP-7345).
- list_milestones — List task milestones for a project.
- list_labels — List task labels for a project.
Tools — /api/mcp/report (12)
- list_report_formats — List all available report formats.
- get_report_format — Get report format details by ID.
- list_reports — List reports with optional filtering and pagination.
- get_report — Get report details by ID.
- create_report — Create a new report.
- update_report — Update an existing report.
- delete_report — Delete a report.
- complete_report — Submit (complete) a report.
- review_report — Mark a submitted report as reviewed.
- list_report_comments — List comments on a report.
- create_report_comment — Add a comment to a report.
- mark_report_as_read — Mark a report as read for the current user.
Tools — /api/mcp/file (63)
- list_files — List files in the TWP file management feature (ファイル管理).
- get_file — Get a file's metadata (name, size, content type, scope, folder, tags, publish status, thumbnail URL) by ID.
- get_file_download_url — Get a short-lived pre-signed download URL for a file (data.download_url).
- get_file_content — Get the text content of a text / Markdown file.
- list_file_tags — List tags used in the tenant's file management (including pre-registered master tags).
- list_recent_files — List files you viewed recently (newest first).
- list_file_projects — List projects whose files you can access (id, name, code, file_count, files_enabled).
- generate_file_upload_url — Step 1 of 3 to upload a file to file management (NOT a task attachment; for task attachments use generate_upload_url on /api/mcp).
- complete_file_upload — Step 3 of 3 of the file upload: register the file after its bytes were PUT to the upload_url from generate_file_upload_url.
- update_file — Update a file's name, description or tags.
- update_file_content — Overwrite the text content of a text / Markdown file (max 500KB, must not be blank).
- move_file — Move a file to another folder and/or scope.
- publish_file — Publish a file (status → published), or change the visibility / expiry of a file that is already published.
- convert_file_to_hls — Start converting a video file (mp4 etc.) to HLS streaming format (720p / 480p adaptive, with a poster image).
- unpublish_file — Unpublish a file (status → draft).
- archive_file — Archive a file (status → archived).
- schedule_file_publish — Set the publish schedule of a file: it is published at publish_start_at and, if publish_end_at is given, unpublished at publish_end_at.
- delete_file — Move a file to the trash (restorable with restore_file; see list_file_trash).
- list_file_trash — List files in the trash.
- restore_file — Restore a file from the trash.
- permanently_delete_file — Permanently delete a file that is in the trash.
- list_folders — List folders directly under parent_id (or the root of the scope).
- get_folder — Get a folder's metadata (name, scope, parent_id, path, file_count, subfolder_count) by ID.
- get_folder_tree — Get the folder tree of a scope (or the subtree under root_id).
- create_folder — Create a folder.
- update_folder — Rename a folder.
- move_folder — Move a folder under another folder in the same scope.
- delete_folder — Move an empty folder to the trash (restorable with restore_folder; see list_folder_trash).
- list_folder_trash — List folders in the trash.
- restore_folder — Restore a folder from the trash, together with the contents that were deleted with it.
- bulk_unpublish_files — Unpublish multiple files at once (status → draft).
- bulk_archive_files — Archive multiple files at once (status → archived).
- bulk_delete_files — Move multiple files to the trash at once (restorable with bulk_restore_files / restore_file).
- bulk_restore_files — Restore multiple files from the trash at once (see list_file_trash).
- bulk_permanently_delete_files — Permanently delete multiple files that are in the trash.
- bulk_publish_files — Publish multiple files at once (status → published) with visibility link (anyone with the link).
- bulk_move_files — Move multiple files to one destination folder / scope at once.
- bulk_download_files — Download multiple files as one ZIP.
- check_file_name_duplicates — Check whether file names already exist in a folder before uploading (same-name check).
- find_duplicate_files — Find files whose content is identical to the given file (same hash), across the scopes you can access.
- list_file_versions — List the versions of a file, newest first.
- get_file_version — Get the metadata of one version of a file.
- get_file_version_download_url — Get a short-lived pre-signed download URL for one version of a file.
- compare_file_versions — Compare two versions of a file: data.from / data.to (metadata with a download URL each), data.size_diff and data.content_changed.
- rollback_file_version — Restore a file to a past version.
- list_file_comments — List the comments on a file.
- create_file_comment — Post a comment on a file.
- update_file_comment — Edit your own comment on a file (other users' comments cannot be edited).
- delete_file_comment — Delete your own comment on a file (other users' comments cannot be deleted).
- generate_image — Generate an image from a prompt with AI and save it to file management.
- generate_document — Generate a document (Markdown) from a prompt with AI and save it to file management.
- generate_video — Generate a video from a prompt with AI and save it to file management.
- generate_music — Generate music from a prompt with AI and save it to file management.
- remix_image — Create a new image from an existing image file and a prompt with AI.
- remix_video — Create a video from an existing image file and a prompt with AI (image to video).
- remix_video_to_video — Create a new video from an existing video file and a prompt with AI.
- get_generation_task — Get the status of an AI generation task or an HLS conversion task from convert_file_to_hls (task_type=file_conversion) (pending / processing / completed / failed / cancelled).
- list_generation_tasks — List your AI generation tasks, newest first.
- cancel_generation_task — Cancel an AI generation task.
- list_generation_models — List the AI models available for generation, by type (image / document / video / music).
- estimate_generation_cost — Estimate the AI credits a generation would consume (data.estimated_milli_credits; 1000 milli-credits = 1 credit).
- suggest_file_tags — Suggest tags for an image or video file in file management with AI (suggested_tags and confidence_scores).
- summarize_for_generation — Turn long text (e.g.
Tools — /api/mcp/note (14)
- list_notes — List notes with optional filtering and pagination.
- search_notes — Search notes by keyword.
- get_note — Get note details by ID.
- create_note — Create a new note.
- update_note — Update an existing note.
- delete_note — Delete a note by ID.
- list_note_comments — List comments on a note.
- create_note_comment — Add a comment to a note.
- update_note_comment — Update an existing note comment.
- delete_note_comment — Delete a note comment.
- list_note_categories — List note categories for the current tenant.
- create_note_category — Create a new note category.
- update_note_category — Update an existing note category.
- delete_note_category — Delete a note category.
Tools — /api/mcp/hearing (5)
- list_hearings — List hearings with optional filtering and pagination.
- get_hearing — Get hearing details by ID, including design (question structure), objectives, and metadata.
- list_hearing_sessions — List sessions for a hearing.
- get_hearing_session — Get a specific hearing session with full details including transcript (conversation history) and AI-generated summary.
- list_hearing_trackers — List trackers (notification/reminder schedules) for a hearing.
Tools — /api/mcp/sales (27)
- list_estimates — List sales estimates (見積) with optional filtering.
- get_estimate — Get a sales estimate (見積) by ID, including line-item details.
- create_estimate — Create a sales estimate (見積).
- update_estimate — Update a sales estimate (見積).
- list_estimate_allocations — Get the department allocations (部署按分) of a sales estimate: department_id, department_name, amount and percentage per row.
- set_estimate_allocations — Replace ALL department allocations (部署按分) of a sales estimate with the given rows (same as saving the allocation dialog on screen; existing rows not included are removed).
- delete_estimate_allocations — Remove all department allocations (部署按分) of a sales estimate.
- list_contracts — List sales contracts (契約) with optional filtering.
- get_contract — Get a sales contract (契約) by ID, including line-item details.
- create_contract — Create a sales contract (契約) from an estimate.
- update_contract — Update a sales contract (契約).
- list_invoices — List sales invoices (請求) with optional filtering.
- get_invoice — Get a sales invoice (請求) by ID, including line-item details and deposit allocation status.
- create_invoice — Create a sales invoice (請求).
- update_invoice — Update a sales invoice (請求).
- list_deposits — List deposits (入金) with optional filtering.
- get_deposit — Get a deposit (入金) by ID, including its allocations to invoices.
- create_deposit — Record a deposit (入金).
- update_deposit — Update a deposit (入金) header.
- list_sales_companies — List client companies (取引先企業) for use as company_id in estimates/invoices.
- list_business_places — List business places (事業所) for use as business_place_id.
- list_payees — List payees (振込先) for use as payee_id in invoices/deposits.
- list_seal_impressions — List seal impressions (印影) for use as seal_impression_id.
- list_estimate_formats — List estimate formats (見積フォーマット) for use as estimate_format_id.
- list_estimate_no_rules — List estimate numbering rules (見積番号ルール) for use as estimate_no_rule_id.
- list_invoice_no_rules — List invoice numbering rules (請求番号ルール) for use as invoice_no_rule_id.
- get_sales_company — Get a client company (取引先企業) by ID.
Tools — /api/mcp/prospect (7)
- search_prospects — Search prospects (見込客).
- get_prospect — Get a prospect (見込客) by ID, including contact info, campaigns, tags, approach state and promotion info.
- create_prospect — Create a single prospect (見込客).
- bulk_create_prospects — Create up to 300 prospects (見込客) in one request — the intended way to load a list (exhibition roster, scraped list, etc.).
- update_prospect — Update a prospect (見込客).
- delete_prospect — Delete a prospect (見込客).
- list_prospect_campaigns — List campaigns (施策マスタ) for referencing campaign_ids when creating or updating prospects.
Tools — /api/mcp/customer (12)
- list_customers — List customer companies (顧客企業).
- get_customer — Get a customer company (顧客企業) by ID, including its contact count and recent interaction summary.
- create_customer_company — Create a customer company (顧客企業).
- update_customer_company — Update a customer company (顧客企業).
- list_customer_contacts — List the people (人物・担当者) registered under a customer company.
- get_customer_contact — Get one person (人物・担当者) of a customer company by ID.
- create_customer_contact — Register a person (人物・担当者) under a customer company.
- update_customer_contact — Update a person (人物・担当者) of a customer company.
- list_customer_interactions — List the interaction history (対応履歴) of a customer company (company_id) or a prospect / アプローチ先 (prospect_id), newest first.
- get_customer_interaction — Get one interaction (対応履歴) of a customer company by ID.
- create_customer_interaction — Record an interaction (対応履歴) — a call, email, visit or web meeting — with a customer company (company_id) or a prospect / アプローチ先 (prospect_id).
- update_customer_interaction — Update an interaction (対応履歴) of a customer company (company_id) or a prospect / アプローチ先 (prospect_id).
Tools — /api/mcp/attendance (2)
- get_my_attendance — Get YOUR OWN attendance (自分の勤怠) per day for a date or a date range (max 31 days): clock-in/clock-out time, break minutes, work minutes, overtime, holiday flags and memo.
- list_my_project_work_time — List YOUR OWN work time per project (自分のプロジェクト別作業時間) per day for a date or a date range (max 31 days).
Tools — /api/mcp/budget (5)
- get_budget_allocations — Get the department allocation settings (部署按分設定) of a project used by 予実管理 (budget vs actual).
- set_budget_allocations — Replace ALL department allocation settings (部署按分設定) of a project.
- get_budget_targets — Get the monthly sales / profit targets (売上目標・利益目標) of 予実管理 (budget vs actual) for a fiscal year.
- set_budget_targets — Create or overwrite the monthly sales / profit targets (売上目標・利益目標) of 予実管理 for a fiscal year in bulk.
- copy_budget_targets_from_previous_year — Copy the monthly sales / profit targets (売上目標・利益目標) of the previous fiscal year (fiscal_year - 1) into fiscal_year.
Tools — /api/mcp/staffing-board (8)
- get_staffing_board — Get the staffing board (要員調整ボード) table: per member, the assigned hours / utilization of each month in start_ym..end_ym (same response as the 人材別アサイン API).
- get_staffing_board_settings — Get the staffing board settings: excluded_project_ids (projects not counted in the board totals, 集計対象外) / member_visibility (user_id -> show|hide, manual overrides of the default 'regular employees only' rows) / utilization_over_threshold / utilization_low_threshold (%; a month is over-utilized above the upper one and available at or below the lower one; default 100 / 60) / updated_at / updated_by.
- list_staffing_board_tentative_assignments — List tentative assignments (仮アサイン) of the staffing board, tenant-wide in member order.
- list_staffing_board_notes — List the staffing board notes (メモ), tenant-wide.
- list_staffing_board_snapshots — List the saved staffing board snapshots (会議ごとに凍結したボード), newest first.
- get_staffing_board_snapshot — Get a staffing board snapshot: rows (each month is official + tentative hours / utilization), notes, and the extracted available members / over-utilized members / members whose contract ends (judged with the board's utilization thresholds at the time the snapshot was saved).
- diff_staffing_board_snapshots — Compare two staffing board snapshots: what changed from base to snapshot_id.
- list_staffing_board_cell_history — List the edit history of one staffing board cell (project × member), same as the cell's 修正履歴 on the screen.
Tools — /api/mcp/support (10)
- list_support_categories — List support request categories available to the current tenant (active ones only).
- list_supports — List support requests.
- get_support — Get a support request with its comment history and status history.
- update_support — Update the title, body or category of your own support request.
- create_support — Create a support request to the TWP operators, filed as yourself (the requester side).
- create_support_comment — Add a comment to a support request as the requester (tenant side), not as a TWP operator.
- create_support_attachment_upload_url — Issue a pre-signed URL for attaching a file to a support request.
- withdraw_support — Withdraw your own support request (you no longer need an answer).
- close_support — Close your own support request, confirming the operators' answer resolved it.
- reinquire_support — Ask again on your own support request when the operators' answer did not resolve it.
Tools — /api/mcp/personal (48)
- backlog_list_spaces — List Backlog spaces configured in the user's external integrations.
- backlog_list_projects — List projects in a Backlog space.
- backlog_list_issues — List or search issues in a Backlog space.
- backlog_get_issue — Get details of a specific Backlog issue by ID or key.
- backlog_list_issue_comments — List comments on a Backlog issue.
- backlog_list_issue_types — List issue types for a Backlog project.
- backlog_list_priorities — List priorities for a Backlog space.
- backlog_list_statuses — List statuses for a Backlog project.
- backlog_list_users — List members of a Backlog project.
- backlog_create_issue — Create a new issue in a Backlog project.
- backlog_update_issue — Update an existing Backlog issue.
- backlog_create_issue_comment — Add a comment to a Backlog issue.
- backlog_list_issue_attachments — List attachments of a Backlog issue.
- backlog_download_attachment — Get download URL for a Backlog issue attachment.
- backlog_upload_attachment — Get upload instructions for Backlog.
- backlog_delete_issue — Delete a Backlog issue.
- backlog_delete_issue_comment — Delete a comment on a Backlog issue.
- outlook_list_messages — List email messages from Outlook.
- outlook_get_message — Get a specific email message by ID from Outlook.
- outlook_send_message — Send an email via Outlook.
- outlook_list_attachments — List attachments of an email message.
- outlook_get_attachment — Get attachment metadata and download URL.
- outlook_reply_message — Reply to an email message.
- outlook_reply_all_message — Reply-all to an email message.
- outlook_forward_message — Forward an email message to specified recipients.
- teams_list_chats — List Teams chats the user is a member of.
- teams_list_chat_messages — List messages in a specific Teams chat.
- teams_send_chat_message — Send a message to a Teams chat.
- teams_list_mentions — List Teams messages that mention you, across 1:1/group chats and channels, filtered by time window and read state.
- teams_list_favorites — List your own favorite Teams channels and chats, each with the purpose (`description`) you saved for it, in your `sort_order` per kind.
- teams_list_teams — List Teams the user is a member of.
- teams_list_team_members — List members of a Teams team.
- teams_list_channels — List channels in a Teams team.
- teams_list_channel_messages — List root posts in a Teams channel.
- teams_list_message_replies — List thread replies to a root post in a Teams channel.
- teams_send_channel_message — Post a message to a Teams channel.
- teams_reply_channel_message — Reply to a message in a Teams channel.
- teams_get_channel_files_folder — Get the Drive info (driveId, itemId) for a Teams channel's file folder.
- drive_list_files — List files and folders in a OneDrive/SharePoint drive folder.
- drive_get_file_info — Get metadata of a file or folder in OneDrive/SharePoint.
- drive_download_file — Get download URL for a file from OneDrive/SharePoint.
- drive_upload_file — Upload a file to OneDrive/SharePoint.
- drive_create_sharing_link — Create a sharing link for a file in OneDrive/SharePoint.
- calendar_list_events — List calendar events from Outlook Calendar.
- calendar_get_event — Get a specific calendar event by ID.
- calendar_create_event — Create a new calendar event in Outlook Calendar.
- calendar_update_event — Update an existing calendar event.
- calendar_delete_event — Delete a calendar event.
Tools — /api/mcp/worker-agent (18)
- list_worker_agent_tools — List the tools a worker agent can be allowed to call (the catalog).
- get_worker_agent_tool — Get a worker agent tool's details, including its input schema and required scopes.
- get_worker_agent_limits — Get worker agent quotas and current usage: enabled agents (max 3 per user / 20 per tenant), runs per day, and — when agent_id is given — that agent's manual runs today (max 20 per agent per day).
- list_worker_agents — List your worker agents (only agents you own).
- get_worker_agent — Get worker agent details (instruction, allowed tools, schedule, enabled state, next run).
- create_worker_agent — Create a worker agent (an autonomous agent that runs an instruction with allowed tools on a schedule).
- update_worker_agent — Update a worker agent (partial update: only the fields you pass are changed).
- delete_worker_agent — Delete a worker agent.
- enable_worker_agent — Enable a worker agent (counts against the enabled-agent quota: 3 per user / 20 per tenant).
- disable_worker_agent — Disable a worker agent (stops scheduled runs; the agent and its run history are kept).
- run_worker_agent — Start a manual run of your worker agent now.
- list_worker_agent_runs — List a worker agent's runs (newest first).
- get_worker_agent_run — Get a worker agent run.
- get_worker_agent_run_steps — Get the step log (tool calls and results in time order) of a worker agent run.
- cancel_worker_agent_run — Request cancellation of a running worker agent run.
- list_agent_schedules — List container agent schedules (定期実行: recurring coding-agent runs against a repository) in your tenant.
- get_agent_schedule — Get one container agent schedule.
- list_agent_schedule_runs — List the run history of a container agent schedule, newest first (each run: run_id, result = 'started' | 'skipped' | 'start_failed', skip_reason when skipped ('previous_session_active' | 'tenant_daily_limit_exceeded' | 'credit_insufficient' | 'owner_unavailable' | 'monthly_credit_limit_exceeded'), session_id, and — once the session finishes — outcome ('succeeded' | 'failed' | 'runtime_limit_reached'), finished_at, pr_url).
Tools — /api/mcp/project-master (8)
- list_processes — List process (工程) master records of the tenant.
- get_process — Get a process (工程) master record by ID.
- create_process — Create a process (工程) master record.
- update_process — Update a process (工程) master record.
- list_quality_check_items — List quality check item (品質チェック項目) master records of the tenant.
- get_quality_check_item — Get a quality check item (品質チェック項目) master record by ID.
- create_quality_check_item — Create a quality check item (品質チェック項目).
- update_quality_check_item — Update a quality check item (品質チェック項目).
Tools — /api/mcp/knowledge/[slug] (4)
- knowledge_manifest — Get the overview of this knowledge base (name, description, document count).
- knowledge_list — List published documents (path, title, summary; no body) in path order.
- knowledge_read — Read one published document (Markdown body included) by its path.
- knowledge_search — Keyword search over published documents.
Tools — /api/mcp/knowledge-auth/[slug] (4)
- knowledge_manifest — Get the overview of this knowledge base (name, description, document count).
- knowledge_list — List published documents (path, title, summary; no body) in path order.
- knowledge_read — Read one published document (Markdown body included) by its path.
- knowledge_search — Keyword search over published documents.
Tools — /api/mcp/knowledge-admin (4)
- knowledge_put_doc — Create or update a draft document (knowledge base admins only).
- knowledge_delete_doc — Delete a draft document (knowledge base admins only).
- knowledge_move_doc — Move (rename) a draft document to another path (knowledge base admins only).
- knowledge_publish — Publish drafts so readers can see them (requires the knowledge base admin role).
Authentication
Include your API key as a Bearer token:Authorization: Bearer twpu_xxx