flutter-mcp-toolkit-intentcall-migration
Migrate Flutter app code from removed MCPCallEntry to AgentCallEntry after the hard cut. Use when upgrading mcp_toolkit, fixing compile errors after a major bump, or running flutter-mcp-toolkit migrate agent-entries.
How do I install this agent skill?
npx skills add https://github.com/arenukvern/mcp_flutter --skill flutter-mcp-toolkit-intentcall-migrationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a migration path for Flutter projects using the MCP Toolkit. It includes documentation links and CLI commands for automated code updates. All resources and tools are associated with the project's author and follow standard development practices.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
IntentCall migration — MCPCallEntry → AgentCallEntry
MCPCallEntry is removed from mcp_toolkit. App code must use
AgentCallEntry (from intentcall_core, re-exported by mcp_toolkit).
Canonical migration doc: migration_mcp_call_entry_to_agent_call_entry.md
When to use this skill
dart analyzereports undefinedMCPCallEntryafter upgradingmcp_toolkit- User asks to migrate custom tools/resources to the new API
- Before shipping a major
mcp_toolkitbump to consumers
CLI (preferred)
# Preview (exit 1 if changes pending)
flutter-mcp-toolkit migrate agent-entries --check lib/
# Apply
flutter-mcp-toolkit migrate agent-entries --write lib/
flutter-mcp-toolkit migrate agent-entries --write --namespace my_app lib/main.dart
Alias: migrate mcp-call-entry (same behavior).
After migration — registration
MCPToolkitBinding.addEntries(entries: Set<AgentCallEntry>)addEntries(entries: { ... })beforebootstrapFlutter(runApp: ...)addMcpTool(AgentCallEntry)— still a shortcut for a single entry
Handlers should return AgentResult (AgentResult.success / AgentResult.failure).
For legacy MCPCallResult + MCPToolDefinition handlers, use mcpToolkitTool /
mcpToolkitResource (see flutter-mcp-toolkit-custom-tools).
Legacy pattern (before — do not ship new code)
// BEFORE (removed in Phase 6b)
final tool = MCPCallEntry.tool(
handler: (request) async => MCPCallResult(
message: 'ok',
parameters: {'n': request['n']},
),
definition: MCPToolDefinition(
name: 'my_tool',
description: 'Example',
inputSchema: {'type': 'object', 'properties': {}},
),
);
Target pattern (after)
import 'package:mcp_toolkit/mcp_toolkit.dart';
final tool = AgentCallEntry.tool(
namespace: 'app',
name: 'my_tool',
description: 'Example',
inputSchema: const {
'type': 'object',
'additionalProperties': false,
'properties': {'n': {'type': 'string'}},
'required': ['n'],
},
handler: (final args) async {
final n = args['n']?.toString() ?? '';
return AgentResult.success(
message: 'ok',
data: {'n': n},
);
},
);
await MCPToolkitBinding.instance.addEntries(entries: {tool});
Platform sync (optional)
After tool surfaces compile:
flutter-mcp-toolkit codegen sync --platform web
flutter-mcp-toolkit codegen sync --platform android,ios,macos --check
See docs/platform-notes/android-oem.md for Xiaomi/Huawei (same shortcuts XML as AOSP).
MCP migrate tool
fmt_migrate_agent_entries is shipped (report-only by default; apply: true to
rewrite). CLI equivalent: flutter-mcp-toolkit migrate agent-entries.
Maintainer checklist (in-repo product gate)
flutter-mcp-toolkit migrate agent-entries --checkonshowcase/flutter_test_app/libmake sync-skillsafter anyplugin/skills/editcd mcp_server_dart && dart test test/contract/- Grep: no
MCPCallEntryin skills except this file's BEFORE examples
Hosted IntentCall packages
IntentCall now lives outside this repository. Normal consumer state uses hosted intentcall_* packages.
- Use hosted
intentcall_*: ^0.6.0dependencies for committed consumer state. - Use local path overrides only for deliberate cross-repo development against a local IntentCall checkout.
- Run
flutter pub getandmigrate agent-entries --checkagain after dependency changes. - CI: use
make check-intentcall-hosted-consumerfor hostedmcp_flutterproof; usemake check-intentcall-sibling-matrixonly for deliberate local IntentCall checkout matrix proof. The historicalmake check-intentcall-integrationtarget is a compatibility alias for the sibling-matrix lane, not a fresh-adopter hosted gate.
Related skills
flutter-mcp-toolkit-custom-tools— authoringAgentCallEntrysurfacesflutter-mcp-toolkit-repo-maintainer— CHANGELOG, version pins,sync-skills
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/arenukvern/mcp_flutter/flutter-mcp-toolkit-intentcall-migration">View flutter-mcp-toolkit-intentcall-migration on skillZs</a>