@aws/agentcore 0.3.0-preview.1.0

package/dist/assets/__tests__/assets.snapshot.test.ts

@@ -0,0 +1,139 @@
+/**
+ * Snapshot tests for the assets directory.
+ *
+ * These tests ensure that template files vended to users don't change unexpectedly.
+ * If you intentionally change an asset file, update snapshots with:
+ *
+ *   npm run test:snapshots:update
+ *
+ * See docs/TESTING.md for more information.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { describe, expect, it } from 'vitest';
+
+const ASSETS_DIR = path.resolve(__dirname, '..');
+
+/**
+ * Recursively get all files in a directory
+ */
+function getAllFiles(dir: string, baseDir: string = dir): string[] {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const files: string[] = [];
+
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      // Skip __tests__ directory to avoid circular snapshots
+      if (entry.name === '__tests__' || entry.name === '__snapshots__') {
+        continue;
+      }
+      files.push(...getAllFiles(fullPath, baseDir));
+    } else {
+      // Get relative path from assets dir for cleaner snapshot names
+      const relativePath = path.relative(baseDir, fullPath);
+      files.push(relativePath);
+    }
+  }
+
+  return files.sort();
+}
+
+/**
+ * Read file content, handling binary files gracefully
+ */
+function readFileContent(filePath: string): string {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  return content;
+}
+
+describe('Assets Directory Snapshots', () => {
+  const assetFiles = getAllFiles(ASSETS_DIR);
+
+  it('should have asset files to test', () => {
+    expect(assetFiles.length).toBeGreaterThan(0);
+  });
+
+  describe('File listing', () => {
+    it('should match the expected file structure', () => {
+      expect(assetFiles).toMatchSnapshot('asset-file-listing');
+    });
+  });
+
+  describe('CDK assets', () => {
+    const cdkFiles = assetFiles.filter(f => f.startsWith('cdk/'));
+
+    it.each(cdkFiles)('cdk/%s should match snapshot', file => {
+      const content = readFileContent(path.join(ASSETS_DIR, file));
+      expect(content).toMatchSnapshot();
+    });
+  });
+
+  describe('Python framework assets', () => {
+    const pythonFiles = assetFiles.filter(f => f.startsWith('python/'));
+
+    it.each(pythonFiles)('python/%s should match snapshot', file => {
+      const content = readFileContent(path.join(ASSETS_DIR, file));
+      expect(content).toMatchSnapshot();
+    });
+  });
+
+  describe('MCP assets', () => {
+    const mcpFiles = assetFiles.filter(f => f.startsWith('mcp/'));
+
+    it.each(mcpFiles)('mcp/%s should match snapshot', file => {
+      const content = readFileContent(path.join(ASSETS_DIR, file));
+      expect(content).toMatchSnapshot();
+    });
+  });
+
+  describe('Static assets', () => {
+    const staticFiles = assetFiles.filter(f => f.startsWith('static/'));
+
+    if (staticFiles.length > 0) {
+      it.each(staticFiles)('static/%s should match snapshot', file => {
+        const content = readFileContent(path.join(ASSETS_DIR, file));
+        expect(content).toMatchSnapshot();
+      });
+    } else {
+      it('static directory is empty or does not exist', () => {
+        // Static assets may not exist
+        expect(true).toBe(true);
+      });
+    }
+  });
+
+  describe('TypeScript assets', () => {
+    const tsFiles = assetFiles.filter(f => f.startsWith('typescript/'));
+
+    if (tsFiles.length > 0) {
+      it.each(tsFiles)('typescript/%s should match snapshot', file => {
+        const content = readFileContent(path.join(ASSETS_DIR, file));
+        expect(content).toMatchSnapshot();
+      });
+    } else {
+      it('typescript directory is empty or contains only placeholder files', () => {
+        // TypeScript assets may not exist yet
+        expect(true).toBe(true);
+      });
+    }
+  });
+
+  describe('Root-level assets', () => {
+    const rootFiles = assetFiles.filter(
+      f =>
+        !f.includes('/') ||
+        (f.startsWith('agents/') &&
+          !f.startsWith('cdk/') &&
+          !f.startsWith('python/') &&
+          !f.startsWith('mcp/') &&
+          !f.startsWith('static/') &&
+          !f.startsWith('typescript/'))
+    );
+
+    it.each(rootFiles)('%s should match snapshot', file => {
+      const content = readFileContent(path.join(ASSETS_DIR, file));
+      expect(content).toMatchSnapshot();
+    });
+  });
+});

package/dist/assets/agents/AGENTS.md

@@ -0,0 +1,102 @@
+# AgentCore Project
+
+This project contains configuration and infrastructure for an Amazon Bedrock AgentCore application.
+
+The `agentcore/` directory serves as a declarative model of an AgentCore project along with a concrete implementation
+through the `agentcore/cdk/` project which is modeled to take the configs as input. The project uses a **flat resource
+model** where agents, memories, and credentials are top-level arrays.
+
+## Mental Model
+
+The project uses a **flat resource model**. Agents, memories, and credentials are independent top-level arrays in
+`agentcore.json`. There is no binding or attachment between resources in the schema — each resource is provisioned
+independently. To use a memory or credential from an agent, the application code discovers the resource at runtime
+(e.g., via environment variables or SDK calls).
+
+## Critical Invariants
+
+1. **Schema-First Authority:** The `.json` files are the absolute source of truth. Do not attempt to modify agent
+   behavior by editing the generated CDK code in `cdk/`.
+2. **Resource Identity:** The `name` field in the schema determines the CloudFormation Logical ID.
+   - **Renaming** an agent or target will **destroy and recreate** that resource.
+   - **Modifying** other fields (descriptions, config) will update the resource **in-place**.
+3. **1:1 Validation:** The schema maps directly to valid CloudFormation. If your JSON conforms to the types in
+   `.llm-context/`, it will deploy successfully.
+4. **Resource Removal:** To remove all resources, use `agentcore remove all`. To tear down deployed infrastructure, run
+   `agentcore deploy` after removal — it will detect the empty state and offer a teardown flow.
+
+## Directory Structure
+
+```
+myNewProject/
+├── AGENTS.md               # This file - AI coding assistant context
+├── agentcore/              # AgentCore configuration directory
+│   ├── agentcore.json      # Main project config (AgentCoreProjectSpec)
+│   ├── aws-targets.json    # Deployment targets
+│   ├── .llm-context/       # TypeScript type definitions for AI coding assistants
+│   │   ├── README.md       # Guide to using the schema files
+│   │   ├── agentcore.ts    # AgentCoreProjectSpec types
+│   │   └── aws-targets.ts  # AWS deployment target types
+│   └── cdk/                # AWS CDK project for deployment
+└── app/                    # Application code (if agents were created)
+```
+
+## Schema Reference
+
+The `agentcore/.llm-context/` directory contains TypeScript type definitions optimized for AI coding assistants. Each
+file maps to a JSON config file and includes validation constraints as comments.
+
+| JSON Config                  | Schema File                             | Root Type               |
+| ---------------------------- | --------------------------------------- | ----------------------- |
+| `agentcore/agentcore.json`   | `agentcore/.llm-context/agentcore.ts`   | `AgentCoreProjectSpec`  |
+| `agentcore/aws-targets.json` | `agentcore/.llm-context/aws-targets.ts` | `AWSDeploymentTarget[]` |
+
+### Key Types
+
+- **AgentCoreProjectSpec**: Root project configuration with `agents`, `memories`, `credentials` arrays
+- **AgentEnvSpec**: Agent configuration (runtime, entrypoint, code location)
+- **Memory**: Memory resource with strategies and expiry
+- **Credential**: API key credential provider
+
+### Common Enum Values
+
+- **BuildType**: `'CodeZip'`
+- **NetworkMode**: `'PUBLIC'`
+- **RuntimeVersion**: `'PYTHON_3_10'` | `'PYTHON_3_11'` | `'PYTHON_3_12'` | `'PYTHON_3_13'`
+- **MemoryStrategyType**: `'SEMANTIC'` | `'SUMMARIZATION'` | `'USER_PREFERENCE'`
+
+### Supported Frameworks (for template agents)
+
+- **Strands** - Works with Bedrock, Anthropic, OpenAI, Gemini
+- **LangChain_LangGraph** - Works with Bedrock, Anthropic, OpenAI, Gemini
+- **GoogleADK** - Gemini only
+- **OpenAIAgents** - OpenAI only
+
+### Specific Context
+
+Directory pathing to local projects is required for runtimes. Only Python offers a zip based direct code deploy option.
+
+## Deployment
+
+The `agentcore/cdk/` subdirectory contains an AWS CDK node project.
+
+Deployments of this project are primarily intended to be orchestrated through the `agentcore deploy` command in the CLI.
+
+Alternatively, the project can be deployed directly as a traditional CDK project:
+
+```bash
+cd agentcore/cdk
+npm install
+npx cdk synth   # Preview CloudFormation template
+npx cdk deploy  # Deploy to AWS
+```
+
+## Editing Schemas
+
+When modifying JSON config files:
+
+1. Read the corresponding `agentcore/.llm-context/*.ts` file for type definitions
+2. Check validation constraint comments (`@regex`, `@min`, `@max`)
+3. Use exact enum values as string literals
+4. Use CloudFormation-safe names (alphanumeric, start with letter)
+5. Run `agentcore validate` command to verify changes.

package/dist/assets/cdk/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "trailingComma": "es5",
+  "printWidth": 120,
+  "tabWidth": 2,
+  "semi": true,
+  "singleQuote": true,
+  "arrowParens": "avoid"
+}

package/dist/assets/cdk/README.md

@@ -0,0 +1,14 @@
+# Welcome to your CDK TypeScript project
+
+This is a blank project for CDK development with TypeScript.
+
+The `cdk.json` file tells the CDK Toolkit how to execute your app.
+
+## Useful commands
+
+- `npm run build` compile typescript to js
+- `npm run watch` watch for changes and compile
+- `npm run test` perform the jest unit tests
+- `npx cdk deploy` deploy this stack to your default AWS account/region
+- `npx cdk diff` compare deployed stack with current state
+- `npx cdk synth` emits the synthesized CloudFormation template

package/dist/assets/cdk/bin/cdk.ts

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { AgentCoreStack } from '../lib/cdk-stack';
+import { ConfigIO, type AwsDeploymentTarget } from '@aws/agentcore-cdk';
+import { App, type Environment } from 'aws-cdk-lib';
+import * as path from 'path';
+
+function toEnvironment(target: AwsDeploymentTarget): Environment {
+  return {
+    account: target.account,
+    region: target.region,
+  };
+}
+
+function toStackName(projectName: string, targetName: string): string {
+  return `AgentCore-${projectName}-${targetName}`;
+}
+
+async function main() {
+  // Config root is parent of cdk/ directory. The CLI sets process.cwd() to agentcore/cdk/.
+  const configRoot = path.resolve(process.cwd(), '..');
+  const configIO = new ConfigIO({ baseDir: configRoot });
+
+  const spec = await configIO.readProjectSpec();
+  const targets = await configIO.readAWSDeploymentTargets();
+
+  if (targets.length === 0) {
+    throw new Error('No deployment targets configured. Please define targets in agentcore/aws-targets.json');
+  }
+
+  const app = new App();
+
+  for (const target of targets) {
+    const env = toEnvironment(target);
+    const stackName = toStackName(spec.name, target.name);
+
+    new AgentCoreStack(app, stackName, {
+      spec,
+      env,
+      description: `AgentCore stack for ${spec.name} deployed to ${target.name} (${target.region})`,
+      tags: {
+        'agentcore:project-name': spec.name,
+        'agentcore:target-name': target.name,
+      },
+    });
+  }
+
+  app.synth();
+}
+
+main();

package/dist/assets/cdk/cdk.json

@@ -0,0 +1,88 @@
+{
+  "app": "node dist/bin/cdk.js",
+  "watch": {
+    "include": ["**"],
+    "exclude": ["README.md", "cdk*.json", "tsconfig.json", "package*.json", "yarn.lock", "node_modules", "dist", "test"]
+  },
+  "context": {
+    "@aws-cdk/aws-signer:signingProfileNamePassedToCfn": true,
+    "@aws-cdk/aws-ecs-patterns:secGroupsDisablesImplicitOpenListener": true,
+    "@aws-cdk/aws-lambda:recognizeLayerVersion": true,
+    "@aws-cdk/core:checkSecretUsage": true,
+    "@aws-cdk/core:target-partitions": ["aws", "aws-cn"],
+    "@aws-cdk-containers/ecs-service-extensions:enableDefaultLogDriver": true,
+    "@aws-cdk/aws-ec2:uniqueImdsv2TemplateName": true,
+    "@aws-cdk/aws-ecs:arnFormatIncludesClusterName": true,
+    "@aws-cdk/aws-iam:minimizePolicies": true,
+    "@aws-cdk/core:validateSnapshotRemovalPolicy": true,
+    "@aws-cdk/aws-codepipeline:crossAccountKeyAliasStackSafeResourceName": true,
+    "@aws-cdk/aws-s3:createDefaultLoggingPolicy": true,
+    "@aws-cdk/aws-sns-subscriptions:restrictSqsDescryption": true,
+    "@aws-cdk/aws-apigateway:disableCloudWatchRole": true,
+    "@aws-cdk/core:enablePartitionLiterals": true,
+    "@aws-cdk/aws-events:eventsTargetQueueSameAccount": true,
+    "@aws-cdk/aws-ecs:disableExplicitDeploymentControllerForCircuitBreaker": true,
+    "@aws-cdk/aws-iam:importedRoleStackSafeDefaultPolicyName": true,
+    "@aws-cdk/aws-s3:serverAccessLogsUseBucketPolicy": true,
+    "@aws-cdk/aws-route53-patters:useCertificate": true,
+    "@aws-cdk/customresources:installLatestAwsSdkDefault": false,
+    "@aws-cdk/aws-rds:databaseProxyUniqueResourceName": true,
+    "@aws-cdk/aws-codedeploy:removeAlarmsFromDeploymentGroup": true,
+    "@aws-cdk/aws-apigateway:authorizerChangeDeploymentLogicalId": true,
+    "@aws-cdk/aws-ec2:launchTemplateDefaultUserData": true,
+    "@aws-cdk/aws-secretsmanager:useAttachedSecretResourcePolicyForSecretTargetAttachments": true,
+    "@aws-cdk/aws-redshift:columnId": true,
+    "@aws-cdk/aws-stepfunctions-tasks:enableEmrServicePolicyV2": true,
+    "@aws-cdk/aws-ec2:restrictDefaultSecurityGroup": true,
+    "@aws-cdk/aws-apigateway:requestValidatorUniqueId": true,
+    "@aws-cdk/aws-kms:aliasNameRef": true,
+    "@aws-cdk/aws-kms:applyImportedAliasPermissionsToPrincipal": true,
+    "@aws-cdk/aws-autoscaling:generateLaunchTemplateInsteadOfLaunchConfig": true,
+    "@aws-cdk/core:includePrefixInUniqueNameGeneration": true,
+    "@aws-cdk/aws-efs:denyAnonymousAccess": true,
+    "@aws-cdk/aws-opensearchservice:enableOpensearchMultiAzWithStandby": true,
+    "@aws-cdk/aws-lambda-nodejs:useLatestRuntimeVersion": true,
+    "@aws-cdk/aws-efs:mountTargetOrderInsensitiveLogicalId": true,
+    "@aws-cdk/aws-rds:auroraClusterChangeScopeOfInstanceParameterGroupWithEachParameters": true,
+    "@aws-cdk/aws-appsync:useArnForSourceApiAssociationIdentifier": true,
+    "@aws-cdk/aws-rds:preventRenderingDeprecatedCredentials": true,
+    "@aws-cdk/aws-codepipeline-actions:useNewDefaultBranchForCodeCommitSource": true,
+    "@aws-cdk/aws-cloudwatch-actions:changeLambdaPermissionLogicalIdForLambdaAction": true,
+    "@aws-cdk/aws-codepipeline:crossAccountKeysDefaultValueToFalse": true,
+    "@aws-cdk/aws-codepipeline:defaultPipelineTypeToV2": true,
+    "@aws-cdk/aws-kms:reduceCrossAccountRegionPolicyScope": true,
+    "@aws-cdk/aws-eks:nodegroupNameAttribute": true,
+    "@aws-cdk/aws-ec2:ebsDefaultGp3Volume": true,
+    "@aws-cdk/aws-ecs:removeDefaultDeploymentAlarm": true,
+    "@aws-cdk/custom-resources:logApiResponseDataPropertyTrueDefault": false,
+    "@aws-cdk/aws-s3:keepNotificationInImportedBucket": false,
+    "@aws-cdk/core:explicitStackTags": true,
+    "@aws-cdk/aws-ecs:enableImdsBlockingDeprecatedFeature": false,
+    "@aws-cdk/aws-ecs:disableEcsImdsBlocking": true,
+    "@aws-cdk/aws-ecs:reduceEc2FargateCloudWatchPermissions": true,
+    "@aws-cdk/aws-dynamodb:resourcePolicyPerReplica": true,
+    "@aws-cdk/aws-ec2:ec2SumTImeoutEnabled": true,
+    "@aws-cdk/aws-appsync:appSyncGraphQLAPIScopeLambdaPermission": true,
+    "@aws-cdk/aws-rds:setCorrectValueForDatabaseInstanceReadReplicaInstanceResourceId": true,
+    "@aws-cdk/core:cfnIncludeRejectComplexResourceUpdateCreatePolicyIntrinsics": true,
+    "@aws-cdk/aws-lambda-nodejs:sdkV3ExcludeSmithyPackages": true,
+    "@aws-cdk/aws-stepfunctions-tasks:fixRunEcsTaskPolicy": true,
+    "@aws-cdk/aws-ec2:bastionHostUseAmazonLinux2023ByDefault": true,
+    "@aws-cdk/aws-route53-targets:userPoolDomainNameMethodWithoutCustomResource": true,
+    "@aws-cdk/aws-elasticloadbalancingV2:albDualstackWithoutPublicIpv4SecurityGroupRulesDefault": true,
+    "@aws-cdk/aws-iam:oidcRejectUnauthorizedConnections": true,
+    "@aws-cdk/core:enableAdditionalMetadataCollection": true,
+    "@aws-cdk/aws-lambda:createNewPoliciesWithAddToRolePolicy": false,
+    "@aws-cdk/aws-s3:setUniqueReplicationRoleName": true,
+    "@aws-cdk/aws-events:requireEventBusPolicySid": true,
+    "@aws-cdk/core:aspectPrioritiesMutating": true,
+    "@aws-cdk/aws-dynamodb:retainTableReplica": true,
+    "@aws-cdk/aws-stepfunctions:useDistributedMapResultWriterV2": true,
+    "@aws-cdk/s3-notifications:addS3TrustKeyPolicyForSnsSubscriptions": true,
+    "@aws-cdk/aws-ec2:requirePrivateSubnetsForEgressOnlyInternetGateway": true,
+    "@aws-cdk/aws-s3:publicAccessBlockedByDefault": true,
+    "@aws-cdk/aws-lambda:useCdkManagedLogGroup": true,
+    "@aws-cdk/aws-elasticloadbalancingv2:networkLoadBalancerWithSecurityGroupByDefault": true,
+    "@aws-cdk/aws-ecs-patterns:uniqueTargetGroupId": true
+  }
+}

package/dist/assets/cdk/gitignore.template

@@ -0,0 +1,9 @@
+# Build output
+dist/
+
+# Dependencies
+node_modules/
+
+# CDK asset staging directory
+.cdk.staging
+cdk.out

package/dist/assets/cdk/jest.config.js

@@ -0,0 +1,9 @@
+module.exports = {
+  testEnvironment: 'node',
+  roots: ['<rootDir>/test'],
+  testMatch: ['**/*.test.ts'],
+  transform: {
+    '^.+\\.tsx?$': 'ts-jest',
+  },
+  setupFilesAfterEnv: ['aws-cdk-lib/testhelpers/jest-autoclean'],
+};

package/dist/assets/cdk/lib/cdk-stack.ts

@@ -0,0 +1,38 @@
+import { AgentCoreApplication, type AgentCoreProjectSpec } from '@aws/agentcore-cdk';
+import { CfnOutput, Stack, type StackProps } from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+
+export interface AgentCoreStackProps extends StackProps {
+  /**
+   * The AgentCore project specification containing agents, memories, and credentials.
+   */
+  spec: AgentCoreProjectSpec;
+}
+
+/**
+ * CDK Stack that deploys AgentCore infrastructure.
+ *
+ * This is a thin wrapper that instantiates L3 constructs.
+ * All resource logic and outputs are contained within the L3 constructs.
+ */
+export class AgentCoreStack extends Stack {
+  /** The AgentCore application containing all agent environments */
+  public readonly application: AgentCoreApplication;
+
+  constructor(scope: Construct, id: string, props: AgentCoreStackProps) {
+    super(scope, id, props);
+
+    const { spec } = props;
+
+    // Create AgentCoreApplication with all agents
+    this.application = new AgentCoreApplication(this, 'Application', {
+      spec,
+    });
+
+    // Stack-level output
+    new CfnOutput(this, 'StackNameOutput', {
+      description: 'Name of the CloudFormation Stack',
+      value: this.stackName,
+    });
+  }
+}

package/dist/assets/cdk/npmignore.template

@@ -0,0 +1,6 @@
+*.ts
+!*.d.ts
+
+# CDK asset staging directory
+.cdk.staging
+cdk.out

package/dist/assets/cdk/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "agentcore-cdk-app",
+  "version": "0.1.0",
+  "bin": {
+    "cdk": "dist/bin/cdk.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -w",
+    "test": "jest",
+    "cdk": "npm run build && cdk",
+    "clean": "rm -rf dist",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^24.10.1",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "aws-cdk": "2.1100.1",
+    "prettier": "^3.4.2",
+    "typescript": "~5.9.3"
+  },
+  "dependencies": {
+    "@aws/agentcore-cdk": "^0.1.0-alpha.1",
+    "aws-cdk-lib": "2.234.1",
+    "constructs": "^10.0.0"
+  }
+}

package/dist/assets/cdk/test/cdk.test.ts

@@ -0,0 +1,16 @@
+// import * as cdk from 'aws-cdk-lib/core';
+// import { Template } from 'aws-cdk-lib/assertions';
+// import * as Cdk from '../lib/cdk-stack';
+
+// example test. To run these tests, uncomment this file along with the
+// example resource in lib/cdk-stack.ts
+test('SQS Queue Created', () => {
+  //   const app = new cdk.App();
+  //     // WHEN
+  //   const stack = new Cdk.CdkStack(app, 'MyTestStack');
+  //     // THEN
+  //   const template = Template.fromStack(stack);
+  //   template.hasResourceProperties('AWS::SQS::Queue', {
+  //     VisibilityTimeout: 300
+  //   });
+});

package/dist/assets/cdk/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "lib": ["es2022"],
+    "declaration": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": false,
+    "inlineSourceMap": true,
+    "inlineSources": true,
+    "experimentalDecorators": true,
+    "strictPropertyInitialization": false,
+    "skipLibCheck": true,
+    "typeRoots": ["./node_modules/@types"],
+    "rootDir": ".",
+    "outDir": "dist"
+  },
+  "include": ["bin/**/*", "lib/**/*", "test/**/*"],
+  "exclude": ["node_modules", "cdk.out", "dist"]
+}

package/dist/assets/mcp/python/README.md

@@ -0,0 +1,27 @@
+# {{ name }}
+
+This is a template MCP server generated by the AgentCore CLI.
+
+Demonstrates HTTP tool patterns with proper error handling and retry logic.
+
+## Quick Start
+
+```bash
+# Create and activate virtual environment
+uv venv
+source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+
+# Install dependencies
+uv sync
+
+# Run the server
+uv run server.py
+```
+
+## Available Tools
+
+| Tool              | Description                                            |
+| ----------------- | ------------------------------------------------------ |
+| `lookup_ip`       | Look up geolocation and network info for an IP address |
+| `get_random_user` | Generate a random user profile for testing             |
+| `fetch_post`      | Fetch a post by ID from JSONPlaceholder API            |

package/dist/assets/mcp/python/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "{{ name }}"
+version = "0.1.0"
+description = "MCP Server demonstrating HTTP tool patterns"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp[cli] >= 1.2.0",
+    "httpx >= 0.27.0",
+    "opentelemetry-distro",
+    "opentelemetry-exporter-otlp",
+]
+
+[project.scripts]
+server = "server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]