Skip to Content
Examplesnpm package as tools

📦 Turn an npm package into tools

Stack: Tools: any npm package (stripe, @aws-sdk, octokit) · Execution: SDK (sandboxed) · Secrets: Credentials vault · Output: typed tools, no wrappers

Who it’s for: anyone who wants an agent to use a library, Stripe, AWS, GitHub, without hand-writing a tool per function. What it does: points almyty at an npm package, introspects its exports, and turns the functions you pick into typed tools that run in a hardened sandbox. Re-run discovery when the SDK updates and the parameters follow, no schema drift.

Build it

  1. Add the package as an SDK tool. Tools → Create Tool, choose SDK, enter the package and version (stripe at ^17.0.0), and click Discover: almyty installs it in a sandbox and infers a parameter schema for each function from the package’s own TypeScript types.
  2. Keep the functions you want. Select the ones you need, charges.create, refunds.create, customers.retrieve, review the generated names and parameters, and create them. Each is a JavaScript tool that require()s the package.
  3. Give it its secret. Store the API key in the Credentials vault and reference it from the tool, injected at run time, never in a prompt.
  4. Attach and use. Add the tools to an agent or publish them on a gateway; the agent calls refunds.create like any other tool.

Your new tools, ready to attach or publish

Make it yours

  • Works for @aws-sdk/client-s3, @octokit/rest, lodash, or any package on npm.
  • Combine with a connected API on the same gateway.
  • Re-run Discover after an SDK bump to refresh parameters.

Uses: Platform · SDK tools · Integrations

Modernize legacy SOAPGive an agent a machine