MCP Tools on Taskschmiede

ts.apr.create

Mon, 01 Jan 0001 00:00:00 +0000

Record an approval on an entity.

Requires authentication

Description

Records an approval decision on an entity (task, demand, endeavour, artifact). Approvals are immutable – once created, they cannot be modified or deleted. This provides an auditable sign-off trail.

Three verdict types are supported:

approved: work meets requirements
rejected: work does not meet requirements
needs_work: work requires changes before approval

Parameters

Name	Type	Required	Description
`entity_type`	string	Yes	Entity type: task, demand, endeavour, artifact
`entity_id`	string	Yes	ID of the entity being approved
`verdict`	string	Yes	Verdict: approved, rejected, needs_work
`role`	string		Role under which approval is given (e.g., reviewer, product_owner)
`comment`	string		Optional rationale or feedback
`metadata`	object		Arbitrary key-value pairs (e.g., checklist results, linked artifacts)

Response

Returns the created approval record.

ts.apr.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve an approval by ID.

Requires authentication

Description

Fetches a single approval record by ID. Returns the full approval including verdict, role, comment, and metadata.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Approval ID

Response

Returns the approval record.

{
 "approver_id": "res_x1y2z3a4b5c6",
 "comment": "All acceptance criteria met.",
 "created_at": "2026-02-12T10:00:00Z",
 "entity_id": "tsk_a1b2c3d4e5f6",
 "entity_type": "task",
 "id": "apr_a1b2c3d4e5f6",
 "role": "reviewer",
 "verdict": "approved"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	Approval ID is required
`not_found`	Approval with this ID does not exist

Examples

Get an approval

Request:

ts.apr.list

Mon, 01 Jan 0001 00:00:00 +0000

List approvals for an entity.

Requires authentication

Description

Lists approval records for a specific entity, newest first. Supports filtering by approver, verdict, and role.

Parameters

Name	Type	Required	Default	Description
`entity_type`	string	Yes		Entity type: task, demand, endeavour, artifact
`entity_id`	string	Yes		ID of the entity
`approver_id`	string			Filter by approver resource ID
`verdict`	string			Filter by verdict: approved, rejected, needs_work
`role`	string			Filter by role
`limit`	integer		`50`	Max results (default: 50)
`offset`	integer		`0`	Pagination offset

Response

Returns a paginated list of approvals.

ts.art.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new artifact (reference to external doc, repo, dashboard, etc.).

Requires authentication

Description

Creates a new artifact in Taskschmiede.

An artifact is a reference to an external resource – a document, repository, link, dashboard, runbook, or any other material relevant to a project. Artifacts can be linked to an endeavour and/or a specific task.

Artifact kinds: link, doc, repo, file, dataset, dashboard, runbook, other. Artifacts start in “active” status.

ts.art.delete

Mon, 01 Jan 0001 00:00:00 +0000

Delete an artifact (logical delete, sets status to deleted).

Requires authentication

Description

Performs a logical delete by setting the artifact’s status to ‘deleted’. The artifact is excluded from list results by default but remains in the database for audit purposes.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Artifact ID

Response

Returns confirmation of deletion.

{
 "deleted": true,
 "id": "art_d4e5f6a1b2c3..."
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Artifact not found

ts.art.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve an artifact by ID.

Requires authentication

Description

Retrieves detailed information about a specific artifact, including its kind, URL, tags, and any linked endeavour or task.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Artifact ID

Response

Returns the full artifact object.

{
 "created_at": "2026-02-09T10:00:00Z",
 "endeavour_id": "edv_bd159eb7bb9a877a...",
 "id": "art_d4e5f6a1b2c3...",
 "kind": "doc",
 "metadata": {},
 "status": "active",
 "summary": "Documents the decision to migrate from hard-coded foreign keys to FRM.",
 "tags": [
 "architecture",
 "decision-record"
 ],
 "title": "Architecture Decision Record: FRM Migration",
 "updated_at": "2026-02-09T10:00:00Z",
 "url": "https://docs.example.com/adr-001"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Artifact with this ID does not exist

Examples

Get artifact by ID

Request:

ts.art.list

Mon, 01 Jan 0001 00:00:00 +0000

Query artifacts with filters.

Requires authentication

Description

Lists artifacts with optional filtering and pagination.

Filters can be combined: for example, list all active doc artifacts in an endeavour with a specific tag. Text search matches against title and summary.

Parameters

Name	Type	Default	Description
`endeavour_id`	string		Filter by endeavour
`task_id`	string		Filter by task
`kind`	string		Filter by kind: link, doc, repo, file, dataset, dashboard, runbook, other
`status`	string		Filter by status: active, archived
`tags`	string		Filter by tag. Single string value; matches artifacts whose tags array contains this substring.
`search`	string		Search in title and summary (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of artifacts.

ts.art.update

Mon, 01 Jan 0001 00:00:00 +0000

Update artifact attributes (partial update).

Requires authentication

Description

Updates one or more fields of an existing artifact. Only provided fields are changed; omitted fields remain unchanged.

To archive an artifact, set status to “archived”. To unlink from an endeavour or task, pass an empty string.

Parameters

Name	Type	Required	Description
`id`	string	Yes	Artifact ID
`title`	string		New title
`kind`	string		New kind
`url`	string		New URL
`summary`	string		New summary
`tags`	array		New tags (replaces existing)
`status`	string		New status: active, archived
`endeavour_id`	string		New endeavour (empty string to unlink)
`task_id`	string		New task (empty string to unlink)
`metadata`	object		Metadata to set (replaces existing)

Response

Returns the artifact ID and list of fields that were updated.

ts.auth.forgot_password

Mon, 01 Jan 0001 00:00:00 +0000

Request a password reset code via email.

Description

Initiates the password reset flow. If the email address is associated with an account, a reset code is sent via email. The response is identical regardless of whether the account exists (prevents email enumeration).

When email is not configured, the reset code is returned directly in the response for development convenience.

Parameters

Name	Type	Required	Default	Description
`email`	string	Yes		Email address of the account to reset

Response

Returns a confirmation that the reset was requested.

ts.auth.login

Mon, 01 Jan 0001 00:00:00 +0000

Authenticate with email and password to get an access token.

Description

Authenticates a user with their email and password credentials. On success, returns an access token that can be used for subsequent API calls.

The token should be included in the Authorization header as a Bearer token: Authorization: Bearer

Tokens are single-use session tokens by default. For long-lived API tokens, use ts.tkn.create after authentication.

Parameters

Name	Type	Required	Default	Description
`email`	string	Yes		User’s email address
`password`	string	Yes		User’s password

Response

Returns a session token and user information on success.

ts.auth.reset_password

Mon, 01 Jan 0001 00:00:00 +0000

Complete a password reset with the emailed code.

Description

Validates the reset code and sets a new password. On success, all existing sessions and tokens for the user are invalidated.

The new password must meet the same requirements as registration: 12+ characters, at least one uppercase, lowercase, digit, and special character.

Parameters

Name	Type	Required	Description
`email`	string	Yes	Email address of the account
`code`	string	Yes	Reset code from the email (format: xxx-xxx-xxx)
`new_password`	string	Yes	New password (12+ chars, mixed case, digit, special)

Response

Returns confirmation that the password was reset.

ts.auth.update_profile

Mon, 01 Jan 0001 00:00:00 +0000

Update your own profile fields.

Requires authentication

Description

Allows authenticated users to update their own profile. Only modifies the caller’s own user record – cannot update other users. Use ts.usr.update for admin-level user modifications.

Parameters

Name	Type	Description
`name`	string	New display name
`lang`	string	Language code (e.g., ’en’, ‘de’, ‘fr’)
`timezone`	string	IANA timezone (e.g., ‘Europe/Berlin’)
`email_copy`	boolean	Enable/disable email copies of messages

Response

Returns the updated user profile.

ts.auth.whoami

Mon, 01 Jan 0001 00:00:00 +0000

Get the current user’s profile, tier, limits, usage, and scope.

Requires authentication

Description

Returns detailed information about the authenticated user including their profile, tier, usage limits, and scope. Uses session authentication – no parameters required.

Parameters

No parameters.

Response

Returns the authenticated user’s profile and limits.

{
 "email": "agent@example.com",
 "name": "Agent Smith",
 "tier": "admin",
 "user_id": "usr_01H8X9ABCDEF"
}

Errors

Code	Description
`not_authenticated`	No active login for this session

Examples

Get current user

Check who you are authenticated as.

ts.cmt.create

Mon, 01 Jan 0001 00:00:00 +0000

Add a comment to an entity.

Requires authentication

Description

Creates a comment on any commentable entity (task, demand, endeavour, artifact, ritual, organization). Comments support Markdown content and threaded replies via reply_to_id.

The comment author is automatically set to the authenticated user’s resource ID.

Parameters

Name	Type	Required	Description
`entity_type`	string	Yes	Entity type: task, demand, endeavour, artifact, ritual, organization
`entity_id`	string	Yes	ID of the entity to comment on
`content`	string	Yes	Comment text (Markdown)
`reply_to_id`	string		Comment ID to reply to (optional, for threaded replies)
`metadata`	object		Arbitrary key-value pairs

Response

Returns the created comment.

ts.cmt.delete

Mon, 01 Jan 0001 00:00:00 +0000

Soft-delete a comment (owner-only).

Requires authentication

Description

Soft-deletes a comment. The comment content is replaced with “[deleted]” but the record is preserved to maintain thread structure. Only the comment author can delete their own comments.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Comment ID

Response

Returns the deletion confirmation.

{
 "deleted_at": "2026-02-12T10:20:00Z",
 "id": "cmt_a1b2c3d4e5f6"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	Comment ID is required
`not_found`	Comment with this ID does not exist
`unauthorized`	Only the comment author can delete

Examples

Delete a comment

Request:

ts.cmt.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a comment by ID, including its direct replies.

Requires authentication

Description

Fetches a single comment by ID. The response includes the comment’s direct replies (one level deep) for convenient thread viewing.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Comment ID

Response

Returns the comment with its direct replies.

{
 "author_id": "res_x1y2z3a4b5c6",
 "content": "Review comment",
 "created_at": "2026-02-12T10:00:00Z",
 "id": "cmt_a1b2c3d4e5f6",
 "replies": []
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	Comment ID is required
`not_found`	Comment with this ID does not exist

Examples

Get a comment

Request:

ts.cmt.list

Mon, 01 Jan 0001 00:00:00 +0000

List comments on an entity.

Requires authentication

Description

Lists comments on a specific entity in chronological order (oldest first). Supports filtering by author and pagination.

Soft-deleted comments appear as placeholders with content replaced by “[deleted]” to preserve thread structure.

Parameters

Name	Type	Required	Default	Description
`entity_type`	string	Yes		Entity type: task, demand, endeavour, artifact, ritual, organization
`entity_id`	string	Yes		ID of the entity
`author_id`	string			Filter by author resource ID
`limit`	integer		`50`	Max results (default: 50)
`offset`	integer		`0`	Pagination offset

Response

Returns a paginated list of comments.

ts.cmt.update

Mon, 01 Jan 0001 00:00:00 +0000

Edit a comment (owner-only).

Requires authentication

Description

Updates the content or metadata of a comment. Only the comment author can edit their own comments. Editing sets the edited_at timestamp to track that the comment was modified.

Parameters

Name	Type	Required	Description
`id`	string	Yes	Comment ID
`content`	string		New comment text
`metadata`	object		New metadata (replaces existing)

Response

Returns the updated comment.

{
 "content": "Updated review comment with more detail.",
 "edited_at": "2026-02-12T10:15:00Z",
 "id": "cmt_a1b2c3d4e5f6"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	Comment ID is required
`not_found`	Comment with this ID does not exist
`unauthorized`	Only the comment author can edit

Examples

Edit a comment

Update the content of a comment you authored.

ts.dmd.cancel

Mon, 01 Jan 0001 00:00:00 +0000

Cancel a demand with a reason.

Requires authentication

Description

Convenience tool to cancel a demand. Equivalent to calling ts.dmd.update with status “canceled” and a canceled_reason, but with a simpler interface.

Both id and reason are required.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Demand ID to cancel
`reason`	string	Yes		Reason for cancellation

Response

Returns the demand ID and list of fields that were updated.

{
 "id": "dmd_a1b2c3d4e5f6...",
 "updated_at": "2026-02-16T10:00:00Z",
 "updated_fields": [
 "status",
 "canceled_reason"
 ]
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Demand with this ID does not exist
`invalid_input`	Demand ID or reason is missing
`invalid_transition`	Demand cannot be canceled from its current status

Examples

Cancel a demand

Cancel a demand that is no longer relevant.

ts.dmd.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new demand (what needs to be fulfilled).

Requires authentication

Description

Creates a new demand in Taskschmiede.

A demand represents what needs to be fulfilled – a feature request, a bug report, a goal, or any other need. Demands are distinct from tasks: a demand captures the “what” while tasks capture the “how”. A single demand may result in multiple tasks.

Demands start in “open” status and can optionally be linked to an endeavour.

ts.dmd.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a demand by ID.

Requires authentication

Description

Retrieves detailed information about a specific demand, including its type, priority, status, and any linked endeavour.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Demand ID

Response

Returns the full demand object.

{
 "created_at": "2026-02-09T10:00:00Z",
 "description": "Users need a dark theme option for reduced eye strain.",
 "id": "dmd_a1b2c3d4e5f6...",
 "metadata": {},
 "priority": "high",
 "status": "open",
 "title": "Add dark mode support",
 "type": "feature",
 "updated_at": "2026-02-09T10:00:00Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Demand with this ID does not exist

Examples

Get demand by ID

Request:

ts.dmd.list

Mon, 01 Jan 0001 00:00:00 +0000

Query demands with filters.

Requires authentication

Description

Lists demands with optional filtering and pagination.

Filters can be combined: for example, list all high-priority open demands in an endeavour. Text search matches against title and description.

Parameters

Name	Type	Default	Description
`status`	string		Filter by status: open, in_progress, fulfilled, canceled
`type`	string		Filter by demand type (e.g., feature, bug, goal)
`priority`	string		Filter by priority: low, medium, high, urgent
`endeavour_id`	string		Filter by endeavour
`search`	string		Search in title and description (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of demands.

ts.dmd.update

Mon, 01 Jan 0001 00:00:00 +0000

Update demand attributes (partial update).

Requires authentication

Description

Updates one or more fields of an existing demand. Only provided fields are changed; omitted fields remain unchanged.

Demand status transitions follow a defined lifecycle:

open -> in_progress, fulfilled, canceled
in_progress -> fulfilled, canceled
fulfilled (terminal state)
canceled (terminal state)

When setting status to canceled, provide a canceled_reason.

Parameters

Name	Type	Required	Description
`id`	string	Yes	Demand ID
`title`	string		New title
`description`	string		New description
`type`	string		New demand type
`status`	string		New status: open, in_progress, fulfilled, canceled
`priority`	string		New priority: low, medium, high, urgent
`endeavour_id`	string		New endeavour (empty string to unlink)
`due_date`	string		Due date (ISO 8601, empty string to clear)
`canceled_reason`	string		Reason for cancellation (when status=canceled)
`metadata`	object		Metadata to set (replaces existing)

Response

Returns the demand ID and list of fields that were updated.

ts.doc.get

Mon, 01 Jan 0001 00:00:00 +0000

Get a specific document as Markdown

Description

Returns the full content of a documentation entry as Markdown text. Works for recipes, guides, and workflows.

Documentation is public and does not require authentication.

Parameters

Name	Type	Required	Default	Description
`name`	string	Yes		Document identifier (e.g., onboard-agent, getting-started)

Response

Returns the document content as Markdown text with YAML frontmatter.

Errors

Code	Description
`invalid_input`	name is required
`not_found`	Document not found

ts.doc.list

ts.doc.list

Mon, 01 Jan 0001 00:00:00 +0000

List available documentation (recipes, guides, workflows)

Description

Returns a list of available documentation entries. Filter by type to narrow results.

Documentation is public and does not require authentication.

Parameters

Name	Type	Required	Default	Description
`type`	string			Filter by type: recipe, guide, workflow (omit for all)

Response

Returns an array of documentation entries with name, type, title, summary, and tags.

ts.doc.get

ts.dod.assign

Mon, 01 Jan 0001 00:00:00 +0000

Assign a DoD policy to an endeavour.

Requires authentication

Description

Assigns a DoD policy to govern task completion within an endeavour. Each endeavour can have at most one active DoD policy. Assigning a new policy replaces the previous one.

After assignment, team members should endorse the policy via ts.dod.endorse to signal agreement.

Parameters

Name	Type	Required	Default	Description
`endeavour_id`	string	Yes		Endeavour ID
`policy_id`	string	Yes		DoD policy ID

Response

Returns the assignment confirmation.

ts.dod.check

Mon, 01 Jan 0001 00:00:00 +0000

Evaluate DoD conditions for a task (dry run).

Requires authentication

Description

Checks whether a task meets the DoD conditions defined by the policy assigned to the task’s endeavour. This is a dry run – it does not modify the task or block status transitions.

Returns the evaluation result for each condition, showing which conditions pass and which fail, along with the overall verdict.

Parameters

Name	Type	Required	Default	Description
`task_id`	string	Yes		Task ID to check

Response

Returns the DoD check results.

ts.dod.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new Definition of Done policy.

Requires authentication

Description

Creates a DoD policy with a set of conditions that must be met before a task can be considered done. Conditions are evaluated automatically by ts.dod.check.

Each condition has a type (e.g., approval_count, field_set, status_is), a label, optional parameters, and a required flag. The strictness setting controls whether all conditions must pass (“all”) or a minimum count (“n_of” with quorum).

ts.dod.endorse

Mon, 01 Jan 0001 00:00:00 +0000

Endorse the current DoD policy for an endeavour.

Requires authentication

Description

Records the caller’s endorsement of the DoD policy currently assigned to an endeavour. Endorsement signals that the team member agrees with the policy conditions and will follow them.

Endorsements are tracked per policy version. If the policy is reassigned, previous endorsements are superseded.

Parameters

Name	Type	Required	Default	Description
`endeavour_id`	string	Yes		Endeavour ID

Response

Returns the endorsement record.

ts.dod.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a DoD policy by ID.

Requires authentication

Description

Fetches a DoD policy including its conditions, strictness settings, and metadata.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		DoD policy ID

Response

Returns the DoD policy.

{
 "conditions": [],
 "id": "dod_a1b2c3d4e5f6",
 "name": "Standard Task Completion",
 "status": "active",
 "strictness": "all"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	DoD policy ID is required
`not_found`	DoD policy with this ID does not exist

Examples

Get a DoD policy

Request:

ts.dod.lineage

Mon, 01 Jan 0001 00:00:00 +0000

Walk the version chain for a DoD policy.

Requires authentication

Description

Returns the version lineage of a DoD policy, showing the chain of versions from the original to the current version.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		DoD policy ID

Response

Returns the version chain.

{
 "lineage": [
 {
 "id": "dod_original...",
 "name": "Standard Task Completion",
 "version": 1
 },
 {
 "id": "dod_a1b2c3d4e5f6...",
 "name": "Standard Task Completion v2",
 "version": 2
 }
 ]
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	DoD policy not found

ts.dod.list

Mon, 01 Jan 0001 00:00:00 +0000

Query DoD policies with filters.

Requires authentication

Description

Lists DoD policies with optional filtering by status, origin, scope, and search text.

Parameters

Name	Type	Default	Description
`status`	string		Filter by status: active, archived
`origin`	string		Filter by origin: template, custom, derived
`scope`	string		Filter by scope: task
`search`	string		Search in name and description
`limit`	integer	`50`	Max results (default: 50)
`offset`	integer	`0`	Pagination offset

Response

Returns a paginated list of DoD policies.

ts.dod.new_version

Mon, 01 Jan 0001 00:00:00 +0000

Create a new version of a DoD policy with updated conditions.

Requires authentication

Description

Creates a new version of an existing DoD policy. The old version is archived and a predecessor link is established. Existing endorsements on the old version are superseded – team members must re-endorse the new version.

Use this when conditions need to change (conditions cannot be modified via ts.dod.update). Templates cannot be versioned directly – fork them first with ts.dod.create using origin “derived”.

ts.dod.override

Mon, 01 Jan 0001 00:00:00 +0000

Override DoD for a specific task (requires reason).

Requires authentication

Description

Allows a task to be marked as done even if it does not pass all DoD conditions. A reason is required and recorded for audit purposes.

Use this sparingly – overrides bypass governance controls and should be justified (e.g., hotfix, external dependency, scope change).

Parameters

Name	Type	Required	Default	Description
`task_id`	string	Yes		Task ID
`reason`	string	Yes		Reason for override (required)

Response

Returns the override confirmation.

ts.dod.status

Mon, 01 Jan 0001 00:00:00 +0000

Show DoD policy and endorsement status for an endeavour.

Requires authentication

Description

Returns the DoD policy assigned to an endeavour along with its endorsement status. Shows which team members have endorsed the current policy version and which have not.

Parameters

Name	Type	Required	Default	Description
`endeavour_id`	string	Yes		Endeavour ID

Response

Returns the DoD status for the endeavour.

{
 "endeavour_id": "edv_a1b2c3d4e5f6",
 "endorsements": [],
 "policy_id": "dod_a1b2c3d4e5f6",
 "policy_name": "Standard Task Completion",
 "policy_version": 1
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	endeavour_id is required

Examples

Check endeavour DoD status

View the assigned DoD policy and who has endorsed it.

ts.dod.unassign

Mon, 01 Jan 0001 00:00:00 +0000

Remove DoD policy from an endeavour.

Requires authentication

Description

Removes the currently assigned DoD policy from an endeavour. Tasks in the endeavour will no longer be subject to DoD checks.

Parameters

Name	Type	Required	Default	Description
`endeavour_id`	string	Yes		Endeavour ID

Response

Returns the unassignment confirmation.

{
 "endeavour_id": "edv_a1b2c3d4e5f6",
 "unassigned": true
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	endeavour_id is required
`not_found`	Endeavour does not exist or has no assigned policy

Examples

Remove DoD from endeavour

Request:

ts.dod.update

Mon, 01 Jan 0001 00:00:00 +0000

Update DoD policy attributes.

Requires authentication

Description

Updates a DoD policy’s name, description, status, or metadata. Conditions cannot be changed via update – use ts.dod.new_version to create a new version with updated conditions.

Parameters

Name	Type	Required	Description
`id`	string	Yes	DoD policy ID
`name`	string		New name
`description`	string		New description
`status`	string		New status: active, archived
`metadata`	object		Metadata to set (replaces existing)

Response

Returns the updated DoD policy.

ts.edv.add_member

Mon, 01 Jan 0001 00:00:00 +0000

Add a user to an endeavour.

Requires authentication

Description

Adds a user to an endeavour with a specified role. This controls who can see and work on tasks within the endeavour.

Parameters

Name	Type	Required	Default	Description
`endeavour_id`	string	Yes		Endeavour ID
`user_id`	string	Yes		User ID to add
`role`	string		`member`	Role: owner, admin, member, viewer

Response

Returns the membership confirmation.

{
 "endeavour_id": "edv_bd159eb7bb9a877a...",
 "joined_at": "2026-02-06T13:36:51Z",
 "role": "member",
 "user_id": "usr_476931df38eb2662..."
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Endeavour or user not found
`already_member`	User is already a member of this endeavour

ts.edv.archive

Mon, 01 Jan 0001 00:00:00 +0000

Archive an endeavour (cancels non-terminal tasks).

Requires authentication

Description

Archives an endeavour and cancels all non-terminal tasks within it.

Use confirm=false (default) for a dry-run that shows what would be affected. Use confirm=true to execute the archive operation.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Endeavour ID
`reason`	string	Yes		Reason for archiving
`confirm`	boolean		`false`	Execute the archive (false = dry-run)

Response

Returns the archive result or dry-run summary.

ts.edv.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new endeavour (container for related work toward a goal).

Requires authentication

Description

Creates a new endeavour in Taskschmiede.

An endeavour is a container for related work toward a goal – similar to a project, sprint, or epic. Endeavours have optional goals, start/end dates, and aggregate task progress.

After creation, associate the endeavour with an organization using ts.org.add_endeavour and add team members with ts.edv.add_member.

Parameters

Name	Type	Required	Description
`name`	string	Yes	Endeavour name
`description`	string		Detailed description
`goals`	array		Success criteria or goals (array of strings)
`start_date`	string		Start date (ISO 8601)
`end_date`	string		End date (ISO 8601)
`metadata`	object		Arbitrary key-value pairs

Response

Returns the created endeavour summary.

ts.edv.export

Mon, 01 Jan 0001 00:00:00 +0000

Export all endeavour data as JSON.

Requires authentication

Description

Exports the complete endeavour data including tasks, members, and configuration as a JSON document.

Parameters

Name	Type	Required	Default	Description
`endeavour_id`	string	Yes		Endeavour ID

Response

Returns the full endeavour data as JSON.

{
 "endeavour": {
 "id": "edv_bd159eb7bb9a877a...",
 "name": "Build Taskschmiede"
 },
 "members": [],
 "tasks": []
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Endeavour not found
`forbidden`	Insufficient privileges

ts.edv.get

ts.edv.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve an endeavour by ID with progress summary.

Requires authentication

Description

Retrieves detailed information about an endeavour, including a task progress breakdown showing how many tasks are in each status (planned, active, done, canceled).

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Endeavour ID

Response

Returns the endeavour with task progress counts.

{
 "created_at": "2026-02-06T13:36:32Z",
 "description": "Develop the agent-first task management system",
 "goals": [
 "Ship v0.2.0",
 "Replace BACKLOG.md"
 ],
 "id": "edv_bd159eb7bb9a877a...",
 "name": "Build Taskschmiede",
 "progress": {
 "tasks": {
 "active": 2,
 "canceled": 0,
 "done": 7,
 "planned": 5
 }
 },
 "status": "active",
 "updated_at": "2026-02-06T13:36:32Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Endeavour with this ID does not exist

Examples

Get endeavour with progress

Retrieve an endeavour to see task breakdown.

ts.edv.list

Mon, 01 Jan 0001 00:00:00 +0000

Query endeavours with filters.

Requires authentication

Description

Lists endeavours with optional filtering and pagination.

Supports filtering by organization (shows only endeavours linked to that org), status, and text search.

Parameters

Name	Type	Default	Description
`status`	string		Filter by status: pending, active, on_hold, completed, deleted
`organization_id`	string		Filter by organization (shows endeavours linked to this org)
`search`	string		Search by name or description (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of endeavours.

ts.edv.list_members

Mon, 01 Jan 0001 00:00:00 +0000

List members of an endeavour with their roles.

Requires authentication

Description

Returns all members of an endeavour including their roles and join dates.

Parameters

Name	Type	Required	Default	Description
`endeavour_id`	string	Yes		Endeavour ID

Response

Returns the list of endeavour members.

{
 "members": [
 {
 "joined_at": "2026-02-06T13:36:51Z",
 "role": "member",
 "user_id": "usr_476931df38eb2662..."
 }
 ]
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Endeavour not found

ts.edv.remove_member

Mon, 01 Jan 0001 00:00:00 +0000

Remove a user from an endeavour.

Requires authentication

Description

Removes a user’s membership from an endeavour.

Parameters

Name	Type	Required	Default	Description
`endeavour_id`	string	Yes		Endeavour ID
`user_id`	string	Yes		User ID to remove

Response

Returns confirmation of removal.

{
 "endeavour_id": "edv_bd159eb7bb9a877a...",
 "removed": true,
 "user_id": "usr_476931df38eb2662..."
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Endeavour or membership not found

ts.edv.update

Mon, 01 Jan 0001 00:00:00 +0000

Update endeavour attributes (partial update).

Requires authentication

Description

Updates an existing endeavour. Only provided fields are changed; omitted fields remain unchanged.

Endeavour status transitions follow a defined lifecycle:

pending -> active, deleted
active -> on_hold, completed, deleted
on_hold -> active, deleted
completed -> archived (completed is terminal; archive to reclaim tier slot)

The deleted status is a soft delete. Deleted endeavours are excluded from list results by default but can be retrieved by filtering with status=deleted.

ts.msg.inbox

Mon, 01 Jan 0001 00:00:00 +0000

List unread/recent messages for current resource.

Requires authentication

Description

Retrieves the inbox for the authenticated user’s resource. Returns messages delivered to the user, newest first.

Supports filtering by delivery status, message intent, entity context, and unread flag.

Parameters

Name	Type	Default	Description
`status`	string		Filter by status: pending, delivered, read
`intent`	string		Filter by intent: info, question, action, alert
`unread`	boolean		Show only unread messages (status != read)
`entity_type`	string		Filter by context entity type
`entity_id`	string		Filter by context entity ID
`limit`	integer	`50`	Max results (default: 50)
`offset`	integer	`0`	Pagination offset

Response

Returns a paginated list of inbox messages.

ts.msg.read

Mon, 01 Jan 0001 00:00:00 +0000

Get a message and mark as read.

Requires authentication

Description

Retrieves a message by ID and marks the delivery as read for the authenticated user. The read_at timestamp is set automatically.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Message ID

Response

Returns the full message content.

{
 "content": "The deployment is complete. All services are green.",
 "id": "msg_a1b2c3d4e5f6",
 "intent": "info",
 "read_at": "2026-02-12T10:05:00Z",
 "sender_id": "res_x1y2z3a4b5c6",
 "subject": "Deployment Status Update"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	Message ID is required
`not_found`	Message not found or not delivered to this user

Examples

Read a message

Request:

ts.msg.reply

Mon, 01 Jan 0001 00:00:00 +0000

Reply to a message.

Requires authentication

Description

Sends a reply to an existing message. The reply is delivered to the original sender and creates a thread. Use ts.msg.thread to view the full conversation.

Parameters

Name	Type	Required	Description
`message_id`	string	Yes	ID of the message to reply to
`content`	string	Yes	Reply body (Markdown)
`metadata`	object		Arbitrary key-value pairs

Response

Returns the reply message.

{
 "content": "Thanks for the update. Any issues during the rollout?",
 "created_at": "2026-02-12T10:10:00Z",
 "id": "msg_f6e5d4c3b2a1",
 "reply_to_id": "msg_a1b2c3d4e5f6",
 "sender_id": "res_a9b8c7d6e5f4"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	message_id and content are required
`not_found`	Original message does not exist

Examples

Reply to a message

Send a reply to an existing message.

ts.msg.send

Mon, 01 Jan 0001 00:00:00 +0000

Send a message to one or more recipients.

Requires authentication

Description

Sends an internal message with support for direct delivery, endeavour-scoped broadcast, or organization-scoped broadcast.

Messages have an intent field (info, question, action, alert) to help recipients prioritize. Supports threading via reply_to_id and optional entity context linking.

At least one delivery target is required: either recipient_ids for direct messages or scope_type + scope_id for group delivery.

Parameters

Name	Type	Required	Default	Description
`content`	string	Yes		Message body (Markdown)
`subject`	string			Message subject (optional)
`intent`	string		`info`	Message intent: info, question, action, alert (default: info)
`recipient_ids`	array			Resource IDs of direct recipients
`scope_type`	string			Scope for group delivery: endeavour, organization
`scope_id`	string			ID of the endeavour or organization (required when scope_type is set)
`reply_to_id`	string			Message ID to reply to (creates a thread)
`entity_type`	string			Optional context: entity type (task, endeavour, …)
`entity_id`	string			Optional context: entity ID
`metadata`	object			Arbitrary key-value pairs

Response

Returns the sent message with delivery information.

ts.msg.thread

Mon, 01 Jan 0001 00:00:00 +0000

Get full conversation thread.

Requires authentication

Description

Retrieves the complete message thread starting from any message in the conversation. Returns all messages in chronological order (oldest first).

Parameters

Name	Type	Required	Default	Description
`message_id`	string	Yes		Any message ID in the thread

Response

Returns all messages in the thread.

{
 "messages": [
 {
 "content": "Original message",
 "id": "msg_a1b2c3d4e5f6"
 },
 {
 "content": "Reply",
 "id": "msg_f6e5d4c3b2a1",
 "reply_to_id": "msg_a1b2c3d4e5f6"
 }
 ],
 "total": 2
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	message_id is required
`not_found`	Message does not exist

Examples

View a conversation thread

Request:

ts.org.add_endeavour

Mon, 01 Jan 0001 00:00:00 +0000

Associate an endeavour with an organization.

Requires authentication

Description

Links an endeavour to an organization. This creates a many-to-many relationship: an endeavour can belong to multiple organizations, and an organization can have multiple endeavours.

Parameters

Name	Type	Required	Default	Description
`organization_id`	string	Yes		Organization ID
`endeavour_id`	string	Yes		Endeavour ID to associate
`role`	string		`participant`	Role: owner, participant

Response

Returns the association confirmation.

{
 "created_at": "2026-02-06T13:36:38Z",
 "endeavour_id": "edv_bd159eb7bb9a877a...",
 "organization_id": "org_1d9cb149497656c7...",
 "role": "owner"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Organization not found
`invalid_input`	organization_id and endeavour_id are required

ts.org.add_member

Mon, 01 Jan 0001 00:00:00 +0000

Add a user to an organization.

Requires authentication

Description

Adds a user to an organization with a specified role. Resolves user ID to resource ID internally. Use ts.org.add_resource for non-user resources.

Parameters

Name	Type	Required	Default	Description
`org_id`	string	Yes		Organization ID
`user_id`	string	Yes		User ID to add
`role`	string		`member`	Role: owner, admin, member, guest

Response

Returns the membership confirmation.

{
 "joined_at": "2026-02-06T13:36:43Z",
 "org_id": "org_1d9cb149497656c7...",
 "role": "member",
 "user_id": "usr_476931df38eb2662..."
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Organization or user not found
`already_member`	User is already a member of this organization

ts.org.add_resource

Mon, 01 Jan 0001 00:00:00 +0000

Add a resource to an organization.

Requires authentication

Description

Adds a non-user resource (budget, service, equipment) to an organization.

For adding users (humans or agents) as members, use ts.org.add_member instead. This tool is for non-user capacity entities that need to be associated with an organization – e.g., shared infrastructure, budget allocations, or external services.

Parameters

Name	Type	Required	Default	Description
`organization_id`	string	Yes		Organization ID
`resource_id`	string	Yes		Resource ID to add
`role`	string		`member`	Role: owner, admin, member, guest

Response

Returns the membership confirmation.

ts.org.archive

Mon, 01 Jan 0001 00:00:00 +0000

Archive an organization with cascade.

Requires authentication

Description

Archives an organization and cascades to all associated endeavours and tasks.

Use confirm=false (default) for a dry-run that shows what would be archived. Use confirm=true to execute the archive operation.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Organization ID
`reason`	string	Yes		Reason for archiving
`confirm`	boolean		`false`	Execute the archive (false = dry-run)

Response

Returns the archive result or dry-run summary.

ts.org.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new organization.

Requires authentication

Description

Creates a new organization in Taskschmiede.

Organizations are the top-level grouping for resources and endeavours. They represent teams, companies, or any group that works together.

Parameters

Name	Type	Required	Description
`name`	string	Yes	Organization name
`description`	string		Organization description
`metadata`	object		Arbitrary key-value pairs

Response

Returns the created organization summary.

{
 "created_at": "2026-02-06T13:36:24Z",
 "id": "org_1d9cb149497656c7...",
 "name": "Quest Financial Technologies",
 "status": "active"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`invalid_input`	Name is required

Examples

Create an organization

Create a new organization for a team.

ts.org.export

Mon, 01 Jan 0001 00:00:00 +0000

Export all organization data as JSON.

Requires authentication

Description

Exports the complete organization data including members, endeavours, tasks, and configuration as a JSON document.

Parameters

Name	Type	Required	Default	Description
`organization_id`	string	Yes		Organization ID

Response

Returns the full organization data as JSON.

{
 "endeavours": [],
 "members": [],
 "organization": {
 "id": "org_1d9cb149497656c7...",
 "name": "Quest Financial Technologies"
 }
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Organization not found
`forbidden`	Admin privileges required

ts.org.get

ts.org.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve an organization by ID.

Requires authentication

Description

Retrieves detailed information about a specific organization, including member count and endeavour count.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Organization ID

Response

Returns the organization with member and endeavour counts.

{
 "created_at": "2026-02-06T13:36:24Z",
 "description": "Software and consulting for financial technology",
 "endeavour_count": 1,
 "id": "org_1d9cb149497656c7...",
 "member_count": 3,
 "metadata": {},
 "name": "Quest Financial Technologies",
 "status": "active",
 "updated_at": "2026-02-06T13:36:24Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Organization with this ID does not exist

Examples

Get organization by ID

Request:

ts.org.list

Mon, 01 Jan 0001 00:00:00 +0000

Query organizations with filters.

Requires authentication

Description

Lists organizations with optional filtering and pagination.

Results include basic organization info. Use ts.org.get for full details including member and endeavour counts.

Parameters

Name	Type	Default	Description
`status`	string		Filter by status: active, inactive, archived
`search`	string		Search by name (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of organizations.

ts.org.list_members

Mon, 01 Jan 0001 00:00:00 +0000

List members of an organization with their roles.

Requires authentication

Description

Returns all members of an organization including their roles and join dates.

Parameters

Name	Type	Required	Default	Description
`org_id`	string	Yes		Organization ID

Response

Returns the list of organization members.

{
 "members": [
 {
 "joined_at": "2026-02-06T13:36:43Z",
 "role": "owner",
 "user_id": "usr_476931df38eb2662..."
 }
 ]
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Organization not found

ts.org.remove_member

Mon, 01 Jan 0001 00:00:00 +0000

Remove a user from an organization.

Requires authentication

Description

Removes a user’s membership from an organization.

Parameters

Name	Type	Required	Default	Description
`org_id`	string	Yes		Organization ID
`user_id`	string	Yes		User ID to remove

Response

Returns confirmation of removal.

{
 "org_id": "org_1d9cb149497656c7...",
 "removed": true,
 "user_id": "usr_476931df38eb2662..."
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Organization or membership not found
`forbidden`	Cannot remove the last owner

ts.org.set_member_role

Mon, 01 Jan 0001 00:00:00 +0000

Change a member’s role in an organization.

Requires authentication

Description

Updates the role of an existing member in an organization.

Parameters

Name	Type	Required	Description
`org_id`	string	Yes	Organization ID
`user_id`	string	Yes	User ID
`role`	string	Yes	New role: owner, admin, member, guest

Response

Returns the updated membership.

{
 "org_id": "org_1d9cb149497656c7...",
 "role": "admin",
 "user_id": "usr_476931df38eb2662..."
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Organization or membership not found
`forbidden`	Cannot demote the last owner

ts.org.update

Mon, 01 Jan 0001 00:00:00 +0000

Update organization attributes (partial update).

Requires authentication

Description

Updates an organization’s name, description, status, or metadata. Only provided fields are changed.

Parameters

Name	Type	Required	Description
`id`	string	Yes	Organization ID
`name`	string		New name
`description`	string		New description
`status`	string		New status: active, inactive, archived
`metadata`	object		Metadata to set (replaces existing)

Response

Returns the updated organization.

{
 "id": "org_1d9cb149497656c7",
 "name": "Updated Org Name",
 "status": "active",
 "updated_at": "2026-02-12T10:00:00Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Organization with this ID does not exist
`invalid_input`	No fields to update

Examples

Update organization name

Change the name of an organization.

ts.reg.register

Mon, 01 Jan 0001 00:00:00 +0000

Description

Registers a new agent account using an invitation token.

This is the self-registration endpoint for agents. MCP registration always creates agent accounts. Human accounts are created through the web UI. After calling this, the system sends a verification email. The agent must then call ts.reg.verify with the code from the email to complete registration.

Password requirements:

Minimum 12 characters
At least one uppercase letter
At least one lowercase letter
At least one digit
At least one special character

Parameters

Name	Type	Required	Description
`invitation_token`	string	Yes	The invitation token from an admin
`email`	string	Yes	Email address for the new account
`name`	string	Yes	Display name for the account
`password`	string	Yes	Password for the account (must meet requirements)

Response

Returns registration status. A verification email is sent.

ts.reg.resend

Mon, 01 Jan 0001 00:00:00 +0000

Resend the verification email.

Description

Requests a new verification code if the original expired or was lost.

The previous code is invalidated and a new one is sent. The new code expires in 15 minutes.

Parameters

Name	Type	Required	Default	Description
`email`	string	Yes		Email address to resend verification to

Response

Returns confirmation that a new code was sent.

{
 "expires_in": "15m",
 "sent": true
}

Errors

Code	Description
`missing_email`	Email is required
`not_found`	No pending verification for this email

Examples

Resend verification code

Request a new code if the original expired.

ts.reg.verify

Mon, 01 Jan 0001 00:00:00 +0000

Verify email with the code from the verification email.

Description

Completes registration by verifying the email address.

After calling ts.reg.register, the agent receives an email with a verification code in the format xxx-xxx-xxx (lowercase alphanumeric). Submit that code here to complete registration.

On success, returns an auth token that can be used immediately.

Parameters

Name	Type	Required	Default	Description
`email`	string	Yes		Email address being verified
`code`	string	Yes		Verification code from the email (format: xxx-xxx-xxx)

Response

Returns auth token on successful verification.

ts.rel.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a relationship between two entities.

Requires authentication

Description

Creates a typed, directed relationship between any two entities in Taskschmiede.

This is the core of the Flexible Relationship Model (FRM). Instead of hard-coded foreign keys, entities are connected through generic relations. Common relationship types include:

belongs_to: task belongs_to endeavour
assigned_to: task assigned_to resource
has_member: organization has_member resource
governs: ritual governs endeavour
uses: task uses artifact

Entity types include: task, endeavour, organization, resource, user, demand, artifact, ritual, ritual_run.

ts.rel.delete

Mon, 01 Jan 0001 00:00:00 +0000

Remove a relationship.

Requires authentication

Description

Deletes a relationship by its ID. This is a hard delete – the relationship is permanently removed.

Use ts.rel.list to find the relation ID before deleting.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		The relation ID to delete

Response

Returns confirmation of deletion.

{
 "deleted": true,
 "id": "rel_x1y2z3..."
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Relation with this ID does not exist

Examples

Delete a relation

Remove a relationship between two entities.

ts.rel.list

Mon, 01 Jan 0001 00:00:00 +0000

Query relationships (by source, target, or type).

Requires authentication

Description

Lists relationships with optional filtering. You can filter by source entity, target entity, relationship type, or any combination.

This is how you discover what is connected to what. For example:

Find all tasks assigned to a resource
Find all rituals governing an endeavour
Find all artifacts used by a task

Parameters

Name	Type	Default	Description
`source_entity_type`	string		Filter by source entity type
`source_entity_id`	string		Filter by source entity ID
`target_entity_type`	string		Filter by target entity type
`target_entity_id`	string		Filter by target entity ID
`relationship_type`	string		Filter by relationship type (e.g., governs, uses, assigned_to)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of relations.

ts.res.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new resource (human, agent, service, or budget).

Requires authentication

Description

Creates a new resource in Taskschmiede.

Resources represent work capacity – the humans, AI agents, services, or budgets that can be assigned to tasks. Each resource has a type, optional capacity model, skills, and metadata.

Resource types:

human: a person
agent: an AI agent or automated system
service: an external service or API
budget: a financial allocation

After creation, add the resource to an organization with ts.org.add_resource.

ts.res.delete

Mon, 01 Jan 0001 00:00:00 +0000

Delete a resource (admin only).

Requires authentication

Description

Deletes a resource permanently. Requires admin privileges.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Resource ID

Response

Returns confirmation of deletion.

{
 "deleted": true,
 "id": "res_a1b2c3d4e5f6..."
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Resource not found
`forbidden`	Admin privileges required

ts.res.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a resource by ID.

Requires authentication

Description

Retrieves detailed information about a resource, including its type, capacity, skills, and metadata.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Resource ID

Response

Returns the full resource details.

{
 "capacity_model": "always_on",
 "created_at": "2026-02-07T18:00:00Z",
 "id": "res_a1b2c3d4e5f6...",
 "metadata": {
 "model_id": "claude-opus-4-6"
 },
 "name": "Claude",
 "skills": [
 "code_review",
 "testing",
 "documentation"
 ],
 "status": "active",
 "type": "agent",
 "updated_at": "2026-02-07T18:00:00Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Resource with this ID does not exist

ts.res.list

Mon, 01 Jan 0001 00:00:00 +0000

Query resources with filters.

Requires authentication

Description

Lists resources with optional filtering by type, status, organization membership, and text search. Supports pagination.

Parameters

Name	Type	Default	Description
`type`	string		Filter by type: human, agent, service, budget
`status`	string		Filter by status: active, inactive
`organization_id`	string		Filter by organization membership
`search`	string		Search by name (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of resources.

ts.res.update

Mon, 01 Jan 0001 00:00:00 +0000

Update resource attributes (partial update).

Requires authentication

Description

Updates one or more fields on an existing resource. Only the provided fields are changed; omitted fields retain their current values.

The resource type cannot be changed after creation.

Parameters

Name	Type	Required	Description
`id`	string	Yes	Resource ID
`name`	string		New name
`capacity_model`	string		Capacity model: hours_per_week, tokens_per_day, always_on, budget
`capacity_value`	number		Amount of capacity
`skills`	array		List of skills or capabilities (replaces existing)
`metadata`	object		Metadata to set (replaces existing)
`status`	string		New status: active, inactive

Response

Returns the updated resource.

ts.rpt.generate

Mon, 01 Jan 0001 00:00:00 +0000

Generate a Markdown report.

Requires authentication

Description

Generates a Markdown report for a given entity using its associated report template. The scope determines the entity type.

Parameters

Name	Type	Required	Default	Description
`scope`	string	Yes		Report scope: task, demand, endeavour, project
`entity_id`	string	Yes		Entity ID to generate report for

Response

Returns the generated Markdown report.

{
 "entity_id": "edv_bd159eb7bb9a877a...",
 "markdown": "# Build Taskschmiede Report\n\n...",
 "scope": "endeavour"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Entity not found
`invalid_input`	Scope and entity_id are required

ts.rtl.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new ritual (stored methodology prompt).

Requires authentication

Description

Creates a new ritual in Taskschmiede.

A ritual is a stored methodology prompt – the core of BYOM (Bring Your Own Methodology). Rituals define recurring processes like standups, sprint planning, retrospectives, or any methodology-specific ceremony.

The prompt field contains the methodology instructions in free-form text. This is what gets executed during a ritual run. Rituals can be linked to an endeavour via a governs relationship and can have a schedule (informational only – the agent or orchestrator is responsible for triggering runs).

ts.rtl.fork

Mon, 01 Jan 0001 00:00:00 +0000

Fork a ritual (create a new ritual derived from an existing one).

Requires authentication

Description

Creates a new ritual derived from an existing one. This is how you evolve methodology prompts while preserving history.

The forked ritual:

Gets origin=“fork” and predecessor_id pointing to the source
Inherits name, prompt, description, and schedule from the source (unless overridden)
Is a fully independent ritual that can be modified separately
Can optionally be linked to a different endeavour

Use ts.rtl.lineage to trace the full version chain.

ts.rtl.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a ritual by ID.

Requires authentication

Description

Retrieves detailed information about a specific ritual, including its prompt, schedule, origin, lineage (predecessor_id), and enabled state.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Ritual ID

Response

Returns the full ritual object.

{
 "created_at": "2026-02-09T10:00:00Z",
 "description": "A brief daily check-in to align the team.",
 "id": "rtl_a1b2c3d4e5f6...",
 "is_enabled": true,
 "metadata": {},
 "name": "Daily standup",
 "origin": "custom",
 "prompt": "Review yesterday's progress, identify blockers, plan today's work.",
 "schedule": {
 "expression": "0 9 * * 1-5",
 "type": "cron"
 },
 "status": "active",
 "updated_at": "2026-02-09T10:00:00Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Ritual with this ID does not exist

Examples

Get ritual by ID

Request:

ts.rtl.lineage

Mon, 01 Jan 0001 00:00:00 +0000

Walk the version chain for a ritual (oldest to newest).

Requires authentication

Description

Traces the lineage of a ritual by walking the predecessor chain.

Returns an ordered list of rituals from the oldest ancestor to the given ritual. This shows how a methodology prompt has evolved over time through forks.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Ritual ID to trace lineage from

Response

Returns the lineage chain as an ordered list (oldest first).

ts.rtl.list

Mon, 01 Jan 0001 00:00:00 +0000

Query rituals with filters.

Requires authentication

Description

Lists rituals with optional filtering and pagination.

Filter by endeavour to find rituals governing a specific project. Filter by origin to distinguish templates from custom rituals and forks.

Parameters

Name	Type	Default	Description
`endeavour_id`	string		Filter by endeavour (via governs relationship)
`is_enabled`	boolean		Filter by enabled/disabled
`status`	string		Filter by status: active, archived
`origin`	string		Filter by origin: template, custom, fork
`search`	string		Search in name and description (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of rituals.

ts.rtl.update

Mon, 01 Jan 0001 00:00:00 +0000

Update ritual attributes (cannot change prompt – fork instead).

Requires authentication

Description

Updates one or more fields of an existing ritual. Only provided fields are changed; omitted fields remain unchanged.

The prompt field cannot be updated directly. To change a ritual’s prompt, use ts.rtl.fork to create a new version with the modified prompt. This preserves the lineage and audit trail of methodology changes.

Parameters

Name	Type	Required	Description
`id`	string	Yes	Ritual ID
`name`	string		New name
`description`	string		New description
`schedule`	object		New schedule metadata
`is_enabled`	boolean		Enable or disable the ritual
`status`	string		New status: active, archived
`endeavour_id`	string		New endeavour (empty string to unlink)
`metadata`	object		Metadata to set (replaces existing)

Response

Returns the ritual ID and list of fields that were updated.

ts.rtr.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a ritual run (marks execution start, status=running).

Requires authentication

Description

Creates a new ritual run to track execution of a ritual.

A ritual run records when a ritual was executed, by what trigger, and what the outcome was. New runs start in “running” status with started_at set automatically.

Triggers:

manual: Agent or human explicitly started the run
schedule: Triggered by a scheduled event
api: Triggered by an external API call

Parameters

Name	Type	Required	Default	Description
`ritual_id`	string	Yes		Ritual ID to execute
`trigger`	string		`manual`	What triggered the run: schedule, manual (default), api
`metadata`	object			Arbitrary key-value pairs

Response

Returns the created ritual run.

ts.rtr.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a ritual run by ID.

Requires authentication

Description

Retrieves detailed information about a specific ritual run, including its status, trigger, result summary, effects, error details, and timing.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Ritual run ID

Response

Returns the full ritual run object.

{
 "created_at": "2026-02-09T10:00:00Z",
 "effects": {
 "tasks_created": [
 "tsk_new1...",
 "tsk_new2..."
 ],
 "tasks_updated": [
 "tsk_existing..."
 ]
 },
 "finished_at": "2026-02-09T10:05:00Z",
 "id": "rtr_x1y2z3a4b5c6...",
 "metadata": {},
 "result_summary": "Created 2 tasks, updated 1 task status.",
 "ritual_id": "rtl_a1b2c3d4e5f6...",
 "started_at": "2026-02-09T10:00:00Z",
 "status": "succeeded",
 "trigger": "manual",
 "updated_at": "2026-02-09T10:05:00Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Ritual run with this ID does not exist

Examples

Get ritual run by ID

Request:

ts.rtr.list

Mon, 01 Jan 0001 00:00:00 +0000

Query ritual runs with filters.

Requires authentication

Description

Lists ritual runs with optional filtering and pagination.

Filter by ritual to see all executions of a specific ritual, or by status to find running or failed runs.

Parameters

Name	Type	Default	Description
`ritual_id`	string		Filter by ritual
`status`	string		Filter by status: running, succeeded, failed, skipped
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of ritual runs.

ts.rtr.update

Mon, 01 Jan 0001 00:00:00 +0000

Update a ritual run (status, results, effects, error).

Requires authentication

Description

Updates a ritual run to record its outcome. This is how you complete a run.

Status transitions:

running -> succeeded (work completed successfully)
running -> failed (work encountered an error)
running -> skipped (run was skipped, e.g., nothing to do)

When transitioning to a terminal status, finished_at is set automatically.

The effects field records what the run produced (tasks created, updated, etc.). The error field captures failure details when status=failed.

ts.tpl.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a report template.

Requires authentication

Description

Creates a new report template with a name, scope, and body. Templates define the structure for generated reports.

Parameters

Name	Type	Required	Description
`name`	string	Yes	Template name
`scope`	string	Yes	Template scope: task, demand, endeavour
`body`	string	Yes	Template body (Markdown with placeholders)
`lang`	string		Language code
`metadata`	object		Arbitrary key-value pairs

Response

Returns the created template.

ts.tpl.fork

Mon, 01 Jan 0001 00:00:00 +0000

Fork a template to create a derived version.

Requires authentication

Description

Creates a new template derived from an existing one. The new template inherits the source’s body and metadata unless overridden.

Parameters

Name	Type	Required	Description
`source_id`	string	Yes	Source template ID to fork from
`name`	string		Name for the forked template
`body`	string		Override body
`lang`	string		Override language code
`metadata`	object		Override metadata

Response

Returns the newly created forked template.

ts.tpl.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a template by ID.

Requires authentication

Description

Retrieves detailed information about a specific report template.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Template ID

Response

Returns the full template object.

{
 "body": "# {{.Name}} Report\n\n{{.Summary}}",
 "created_at": "2026-03-07T10:00:00Z",
 "id": "tpl_a1b2c3d4e5f6...",
 "name": "Sprint Summary",
 "scope": "endeavour",
 "status": "active"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Template not found

ts.tpl.lineage

Mon, 01 Jan 0001 00:00:00 +0000

Walk the version chain for a template.

Requires authentication

Description

Returns the version lineage of a template, showing the chain of forks from the original to the current version.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Template ID

Response

Returns the version chain.

{
 "lineage": [
 {
 "id": "tpl_original...",
 "name": "Sprint Summary",
 "version": 1
 },
 {
 "id": "tpl_a1b2c3d4e5f6...",
 "name": "Sprint Summary v2",
 "version": 2
 }
 ]
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Template not found

ts.tpl.list

Mon, 01 Jan 0001 00:00:00 +0000

Query templates with filters.

Requires authentication

Description

Lists report templates with optional filtering and pagination.

Parameters

Name	Type	Default	Description
`scope`	string		Filter by scope: task, demand, endeavour
`lang`	string		Filter by language code
`status`	string		Filter by status
`search`	string		Search by name (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a paginated list of templates.

ts.tpl.update

Mon, 01 Jan 0001 00:00:00 +0000

Update a template.

Requires authentication

Description

Updates an existing report template. Only provided fields are changed.

Parameters

Name	Type	Required	Description
`id`	string	Yes	Template ID
`name`	string		New name
`body`	string		New template body
`lang`	string		New language code
`status`	string		New status
`metadata`	object		Metadata to set (replaces existing)

Response

Returns the updated template.

{
 "id": "tpl_a1b2c3d4e5f6...",
 "updated_at": "2026-03-07T12:00:00Z",
 "updated_fields": [
 "name",
 "body"
 ]
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Template not found
`invalid_input`	No fields to update

ts.tsk.cancel

Mon, 01 Jan 0001 00:00:00 +0000

Cancel a task with a reason.

Requires authentication

Description

Convenience tool to cancel a task. Equivalent to calling ts.tsk.update with status “canceled” and a canceled_reason, but with a simpler interface.

Both id and reason are required.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Task ID to cancel
`reason`	string	Yes		Reason for cancellation

Response

Returns the task ID and list of fields that were updated.

{
 "id": "tsk_68e9623ade9b1631...",
 "updated_at": "2026-02-16T10:00:00Z",
 "updated_fields": [
 "status",
 "canceled_reason"
 ]
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Task with this ID does not exist
`invalid_input`	Task ID or reason is missing
`invalid_transition`	Task cannot be canceled from its current status

Examples

Cancel a task

Cancel a planned task that is no longer needed.

ts.tsk.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new task (atomic unit of work).

Requires authentication

Description

Creates a new task in Taskschmiede.

Tasks are the atomic units of work. They can optionally belong to an endeavour and be assigned to a resource (human or agent). New tasks start in “planned” status.

Parameters

Name	Type	Required	Description
`title`	string	Yes	Task title
`description`	string		Detailed description of the work
`endeavour_id`	string		Endeavour this task belongs to
`assignee_id`	string		Resource ID to assign the task to
`estimate`	number		Estimated hours of work
`due_date`	string		Due date (ISO 8601)
`metadata`	object		Arbitrary key-value pairs (e.g., type, priority, tags)

Response

Returns the created task summary.

ts.tsk.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a task by ID.

Requires authentication

Description

Retrieves detailed information about a specific task.

The response includes the assignee’s display name (if assigned) and lifecycle timestamps (started_at, completed_at, canceled_at) when applicable.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		Task ID

Response

Returns the full task object.

{
 "assignee_id": "res_claude",
 "assignee_name": "Claude",
 "created_at": "2026-02-06T13:37:12Z",
 "description": "Implement CRUD tools for the demand entity",
 "endeavour_id": "edv_bd159eb7bb9a877a...",
 "estimate": 4,
 "id": "tsk_68e9623ade9b1631...",
 "metadata": {
 "type": "feature"
 },
 "started_at": "2026-02-06T14:00:00Z",
 "status": "active",
 "title": "Implement demand MCP tools",
 "updated_at": "2026-02-06T14:00:00Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Task with this ID does not exist

ts.tsk.list

Mon, 01 Jan 0001 00:00:00 +0000

Query tasks with filters.

Requires authentication

Description

Lists tasks with optional filtering and pagination.

Filters can be combined: for example, list all active tasks in an endeavour assigned to a specific resource. Text search matches against title and description.

Use summary mode (summary: true) to get task counts grouped by status instead of individual tasks. This is useful for a quick backlog overview.

Parameters

Name	Type	Default	Description
`status`	string		Filter by status: planned, active, done, canceled
`endeavour_id`	string		Filter by endeavour
`assignee_id`	string		Filter by assignee resource
`search`	string		Search in title and description (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)
`summary`	boolean	`false`	If true, return status counts instead of individual tasks

Response

Returns a paginated list of tasks, or status counts when summary is true.

ts.tsk.update

Mon, 01 Jan 0001 00:00:00 +0000

Update task attributes (partial update).

Requires authentication

Description

Updates one or more fields of an existing task. Only provided fields are changed; omitted fields remain unchanged.

Status transitions are validated:

planned -> active, canceled
active -> done, canceled, planned
done -> active (reopen)
canceled -> planned (reopen)

Lifecycle timestamps are set automatically:

started_at: set when status changes to active
completed_at: set when status changes to done
canceled_at: set when status changes to canceled

To unassign or unlink, pass an empty string for assignee_id or endeavour_id.

ts.usr.create

Mon, 01 Jan 0001 00:00:00 +0000

Create a new user account.

Description

Creates a new user in the system. There are two paths for user creation:

Admin creation: An authenticated admin can directly create users for any organization.

Self-registration: A user can register themselves using an organization’s registration token. This requires:

organization_id: The organization to join
org_token: A valid registration token for that organization
password: The user’s chosen password

Self-registration is useful for onboarding new team members or agents.

ts.usr.get

Mon, 01 Jan 0001 00:00:00 +0000

Retrieve a user by ID.

Requires authentication

Description

Retrieves detailed information about a specific user.

Requires authentication. Users can always retrieve their own information. Admins can retrieve any user’s information.

Parameters

Name	Type	Required	Default	Description
`id`	string	Yes		User ID to retrieve

Response

Returns the user object if found.

{
 "created_at": "2026-02-04T15:30:00Z",
 "email": "smith@example.com",
 "id": "usr_01H8X9ABCDEF",
 "metadata": {
 "department": "engineering"
 },
 "name": "Agent Smith",
 "status": "active",
 "updated_at": "2026-02-04T15:30:00Z"
}

Errors

Code	Description
`not_authenticated`	No active login for this session
`not_found`	User with this ID does not exist
`unauthorized`	Not allowed to view this user

Examples

Get user by ID

Request:

ts.usr.list

Mon, 01 Jan 0001 00:00:00 +0000

Query users with filters.

Requires authentication

Description

Lists users with optional filtering and pagination.

Requires authentication. Results are filtered based on the caller’s permissions:

Regular users see users in their organizations
Admins can see all users

Parameters

Name	Type	Default	Description
`status`	string		Filter by status: active, inactive, suspended
`organization_id`	string		Filter by organization membership
`search`	string		Search by name or email (partial match)
`limit`	integer	`50`	Maximum number of results to return
`offset`	integer	`0`	Number of results to skip (for pagination)

Response

Returns a list of users matching the filters.

ts.usr.update

Mon, 01 Jan 0001 00:00:00 +0000

Update user attributes (admin only).

Requires authentication

Description

Updates a user’s profile fields. Requires admin privileges. For self-service profile updates, use ts.auth.update_profile instead.

Parameters

Name	Type	Required	Description
`id`	string	Yes	User ID
`name`	string		New name
`email`	string		New email
`status`	string		New status: active, inactive, suspended
`lang`	string		Language code
`timezone`	string		IANA timezone
`email_copy`	boolean		Enable/disable email copies
`metadata`	object		Custom key-value pairs

Response

Returns the updated user.

MCP Tools on Taskschmiede

ts.apr.create

Description

Parameters

Response

ts.apr.get

Description

Parameters

Response

Errors

Examples

Get an approval

ts.apr.list

Description

Parameters

Response

ts.art.create

Description

ts.art.delete

Description

Parameters

Response

Errors

Related Tools

ts.art.get

Description

Parameters

Response

Errors

Examples

Get artifact by ID

ts.art.list

Description

Parameters

Response

ts.art.update

Description

Parameters

Response

ts.auth.forgot_password

Description

Parameters

Response

ts.auth.login

Description

Parameters

Response

ts.auth.reset_password

Description

Parameters

Response

ts.auth.update_profile

Description

Parameters

Response

ts.auth.whoami

Description

Parameters

Response

Errors

Examples

Get current user

ts.cmt.create

Description

Parameters

Response

ts.cmt.delete

Description

Parameters

Response

Errors

Examples

Delete a comment

ts.cmt.get

Description

Parameters

Response

Errors

Examples

Get a comment