leehack/mcp_dart

mcpdart is a dual-era Dart and Flutter SDK for MCP clients, servers, and AI
hosts. It implements the complete core client/server wire surface of the locked
MCP 2026-07-28 specification, retains the MCP 2025-11-25 feature set, and
negotiates supported earlier initialization-based specifications.
Here, core means the normative wire requirements assigned to client and server
roles by the pinned final specification. It excludes optional MCP
extensions, host UI behavior, an authorization-server implementation, JSON
Schema external-reference resolution, and custom JSON Schema vocabularies.
> [!IMPORTANT]
> This release is mcpdart 2.4.3. The separately versioned CLI is
> mcpdartcli 0.2.2, which requires mcpdart ^2.4.3.
> Current source passes every scored requirement in the official alpha.11 MCP
> 2025-11-25 and 2026-07-28 client and server sets, including all 25
> required 2026 authorization scenarios, plus bidirectional published
> TypeScript SDK 2.3.1 and Python SDK 2.3.0 interoperability.
## SDK Tier 1 target
The project is pursuing
MCP SDK Tier 1. Tier 1
is not yet claimed or assigned. The technical baseline is green; the remaining
official audit, repository-governance, and SDK Working Group steps are tracked
in the roadmap and
48-feature coverage inventory.
The public maintenance contract is documented in the
contribution guide, security policy,
dependency policy, and
versioning policy.
## Requirements
| Package | Minimum Dart SDK |
| mcpdart 2.4.3 | 3.4 |
| mcpdartcli 0.2.2 | 3.12 |
SDK-only generated projects retain the SDK's Dart 3.4 minimum. CLI projects
use Dart 3.12 because the CLI and its toolchain target that release.
Install Dart from dart.dev.
## Installation
### Production channel
Use the latest stable package for production projects:
bash
dart pub add mcpdart
### Pin the stable SDK release
Pin the stable 2.4 line explicitly when reproducible dependency resolution is
important:
yaml
dependencies:
mcpdart: ^2.4.3
The snippets below use the current stable SDK line. Package versions
remain separate from protocol profiles: McpProtocol.stable names the SDK's
default compatibility policy.
The SDK and CLI are versioned independently. The stable CLI's ^2.4.3
constraint accepts SDK versions from 2.4.3 up to, but not including, 3.0.0.
### AI agent skills
mcpdart ships agent skills for
building servers, building clients, and serving or connecting over Streamable
HTTP. Install them into your coding agent's skills directory from your app's
root:
bash
dart run skills@ get
For direct SDK integration, start with the
getting-started guide.
The CLI below is optional and provides scaffolding, inspection, and conformance
commands.
## What the SDK provides
MCP servers, clients, and host integrations with null-safe Dart APIs.
Core tools, resources, prompts, completion, elicitation, subscriptions,
logging, roots, and sampling APIs with behavior selected for the negotiated
protocol era. MCP 2026-07-28 logging is retained for compatibility but is
deprecated upstream.
Stdio, Streamable HTTP, IO stream, and custom transports.
OAuth client discovery/PKCE hooks, server authentication callbacks, DNS
rebinding protection, and strict Streamable HTTP validation.