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
Caitie McCaffrey 5cac9229cf Use SDK imports for TypeScript and remote refs for JSON Schema
- schema.ts: Import core MCP types from @modelcontextprotocol/sdk/types.js
  instead of inline stubs
- schema.json: Use remote \ URIs pointing to core MCP schema at
  https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/
  main/schema/2025-11-25/schema.json
- Add package.json with SDK and TypeScript as devDependencies
- Add .gitignore for node_modules
- Add skipLibCheck to tsconfig.json
- Add index signature to TaskStatusNotificationParams for SDK type compat

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-05-11 14:37:49 -07:00
docs/specification/2025-11-25 first agentic pass 2026-05-11 14:25:28 -07:00
schema/draft/2025-11-25 Use SDK imports for TypeScript and remote refs for JSON Schema 2026-05-11 14:37:49 -07:00
seps first agentic pass 2026-05-11 14:25:28 -07:00
.gitignore Use SDK imports for TypeScript and remote refs for JSON Schema 2026-05-11 14:37:49 -07:00
CODE_OF_CONDUCT.md first agentic pass 2026-05-11 14:25:28 -07:00
CONTRIBUTING.md first agentic pass 2026-05-11 14:25:28 -07:00
LICENSE first agentic pass 2026-05-11 14:25:28 -07:00
MAINTAINERS.md first agentic pass 2026-05-11 14:25:28 -07:00
package.json Use SDK imports for TypeScript and remote refs for JSON Schema 2026-05-11 14:37:49 -07:00
README.md first agentic pass 2026-05-11 14:25:28 -07:00
SECURITY.md first agentic pass 2026-05-11 14:25:28 -07:00
tsconfig.json Use SDK imports for TypeScript and remote refs for JSON Schema 2026-05-11 14:37:49 -07:00

MCP Tasks Extension (Experimental)

⚠️ Experimental Extension — This repository contains an experimental extension to the Model Context Protocol. It is not an official extension and may change significantly or be discontinued. See the Extensions specification for details on the experimental extension process.

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

Specification

The full specification for Tasks as defined in the 2025-11-25 MCP protocol version can be found at:

SEPs

  • SEP-1686: Tasks — The original proposal that introduced Tasks to the MCP specification.

Status

This extension was originally part of the core MCP specification in the 2025-11-25 release. It is being extracted into an experimental extension to allow the feature to incubate and evolve independently, with the intention of eventually promoting it back into the core protocol once it has stabilized.

The Tasks extension is maintained by the Agents Working Group.

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.