Mirror of https://github.com/modelcontextprotocol/ext-tasks — This repository provides a reference for the tasks extensions to the MCP protocol, allowing for long-running operations, such as Agent communication, in MCP.
  • TypeScript 100%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-08-19 19:30:36 -07:00
.github/workflows Set up Vitepress deployment (#7) 2026-06-09 12:18:41 -07:00
.vitepress Set up Vitepress deployment (#7) 2026-06-09 12:18:41 -07:00
public Set up Vitepress deployment (#7) 2026-06-09 12:18:41 -07:00
schema/draft Write updated docs and port SEP-2663 content (#2) 2026-05-22 12:06:55 -07:00
scripts Write updated docs and port SEP-2663 content (#2) 2026-05-22 12:06:55 -07:00
seps fix: correct MISSING_REQUIRED_CLIENT_CAPABILITY error code to -32021 (#10) 2026-08-19 19:30:36 -07:00
specification/draft Fix Missing Required Client Capability error code (#15) 2026-08-19 19:21:20 -07:00
.gitignore Set up Vitepress deployment (#7) 2026-06-09 12:18:41 -07:00
CODE_OF_CONDUCT.md first agentic pass 2026-05-11 14:25:28 -07:00
CONTRIBUTING.md Set up Vitepress deployment (#7) 2026-06-09 12:18:41 -07:00
index.md Set up Vitepress deployment (#7) 2026-06-09 12:18:41 -07:00
LICENSE first agentic pass 2026-05-11 14:25:28 -07:00
MAINTAINERS.md Update Tasks extension docs to reflect official MCP status (#13) 2026-08-19 19:21:58 -07:00
package-lock.json Bump hono in the npm_and_yarn group across 1 directory (#6) 2026-07-15 13:41:09 -07:00
package.json Set up Vitepress deployment (#7) 2026-06-09 12:18:41 -07:00
README.md Update Tasks extension docs to reflect official MCP status (#13) 2026-08-19 19:21:58 -07:00
SECURITY.md first agentic pass 2026-05-11 14:25:28 -07:00
tsconfig.json generate schema with refs 2026-05-11 15:53:04 -07:00

MCP Tasks Extension

This repository contains the official Model Context Protocol Tasks extension (io.modelcontextprotocol/tasks), based on SEP-2663.

Overview

This extension defines the Tasks primitive for the Model Context Protocol (MCP). Tasks are durable state machines that carry information about the underlying execution state of a request, enabling requestor polling and deferred result retrieval. Each task is uniquely identifiable by a receiver-generated task ID.

Tasks are useful for:

  • Representing expensive computations and batch processing requests
  • Integrating seamlessly with external job/workflow APIs
  • Enabling call-now, fetch-later execution patterns

Extension Identifier: io.modelcontextprotocol/tasks

Development

Schema Generation

The JSON Schema is auto-generated from the TypeScript type definitions using ts-to-zod and Zod's toJSONSchema(). Do not hand-edit schema.json or generated/schema.ts.

# Generate Zod schemas and JSON Schema from schema.ts
npm run generate:schemas

# Verify TypeScript compiles and generated files are up to date
npm run check:schema

Governance

This repository follows the Model Context Protocol Governance process. See MAINTAINERS.md for the list of maintainers specific to this repository.

Policies

This repository follows the Model Context Protocol project policies:

License

This project is licensed under the Apache License 2.0. See LICENSE for details.