get_package_versions

Retrieve available versions and release dates for Dart/Flutter packages from pub.dev to manage dependencies and track updates.

Instructions

Get all available versions of a package with their release dates

Input Schema

TableJSON Schema

Name	Required	Description	Default
`packageName`	Yes	Name of the package to get versions for
`limit`	No	Maximum number of versions to return (default: 10)

Implementation Reference

src/pubdev-mcp.js:265-287 (handler)

The handler function that implements the core logic for the 'get_package_versions' tool: fetches package versions from pub.dev API with caching, limits to the specified number, and formats as JSON response.

async getPackageVersions(packageName, limit = 10) {
    const url = `https://pub.dev/api/packages/${packageName}/versions`;
    const data = await this.fetchWithCache(url, `versions-${packageName}`);
    const versions = data.versions
        .slice(0, limit)
        .map((v) => ({
        version: v.version,
        publishedAt: v.published,
        description: v.pubspec?.description
    }));
    return {
        content: [
            {
                type: "text",
                text: JSON.stringify({
                    packageName,
                    totalVersions: data.versions.length,
                    versions
                }, null, 2)
            }
        ]
    };
}

src/pubdev-mcp.js:60-72 (schema)

Input schema definition for the 'get_package_versions' tool, specifying packageName as required and limit as optional.

inputSchema: {
    type: "object",
    properties: {
        packageName: {
            type: "string",
            description: "Name of the package to get versions for"
        },
        limit: {
            type: "number",
            description: "Maximum number of versions to return (default: 10)"
        }
    },
    required: ["packageName"]

src/pubdev-mcp.js:57-74 (registration)

Tool registration in the list of available tools, including name, description, and input schema.

{
    name: "get_package_versions",
    description: "Get all available versions of a package with their release dates",
    inputSchema: {
        type: "object",
        properties: {
            packageName: {
                type: "string",
                description: "Name of the package to get versions for"
            },
            limit: {
                type: "number",
                description: "Maximum number of versions to return (default: 10)"
            }
        },
        required: ["packageName"]
    }
},

src/pubdev-mcp.js:158-159 (registration)
Switch case that registers and routes incoming tool calls for 'get_package_versions' to the handler method.
```
case "get_package_versions":
    return await this.getPackageVersions(args.packageName, args.limit);
```

src/pubdev-mcp.ts:346-370 (handler)

TypeScript version of the handler function implementing the 'get_package_versions' tool logic with type annotations.

private async getPackageVersions(packageName: string, limit: number = 10) {
  const url = `https://pub.dev/api/packages/${packageName}/versions`;
  const data = await this.fetchWithCache<any>(url, `versions-${packageName}`);
  
  const versions: PackageVersion[] = data.versions
    .slice(0, limit)
    .map((v: any) => ({
      version: v.version,
      publishedAt: v.published,
      description: v.pubspec?.description
    }));

  return {
    content: [
      {
        type: "text",
        text: JSON.stringify({
          packageName,
          totalVersions: data.versions.length,
          versions
        }, null, 2)
      }
    ]
  };
}

Pub.dev MCP Server