Skip to main content

​
TypeScript Install

npm install @grantex/strands @grantex/sdk @strands-agents/sdk zod

​
TypeScript Quick Start

import { Agent } from '@strands-agents/sdk';
import { createGrantexTool } from '@grantex/strands';
import { z } from 'zod';

const readCalendar = createGrantexTool({
  name: 'read_calendar',
  description: 'Read upcoming calendar events',
  inputSchema: z.object({
    date: z.string(),
  }),
  grantToken,
  requiredScope: 'calendar:read',
  callback: async ({ date }) => getCalendarEvents(date),
});

const agent = new Agent({
  tools: [readCalendar],
});
The TypeScript helper verifies the grant token against JWKS before each tool invocation and checks the verified scp claim. Set online: true with a Grantex client and connector to delegate enforcement to client.enforce().

​
Python Install

pip install grantex-strands strands-agents

​
Python Quick Start

from grantex_strands import create_grantex_tool

read_calendar = create_grantex_tool(
    name="read_calendar",
    description="Read upcoming calendar events",
    grant_token=grant_token,
    required_scope="calendar:read",
    func=get_calendar_events,
)
The Python helper verifies the grant token against JWKS and raises PermissionError if the required scope is missing.

​
Requirements

  • Node.js 18+ for @grantex/strands
  • Python 3.11+ for grantex-strands
  • Strands Agents SDK for the language you use