Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Griptape

Scalekit connector
Open markdown

The Griptape connector lets your AI agent act in each user's Griptape account. Each user connects their own Griptape access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.

Tools
59
What they doRead · write · destructive
35 · 15 · 935 read15 write9 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Griptape connection

    In AgentKit > Connections, create a Griptape connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'griptape'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Griptape:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'griptape_buckets_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Griptape credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • griptape_bucket_asset_getGet the metadata of one file in a Griptape Cloud bucket.Read-only

    Get Bucket Asset

    Get the metadata of one file in a Griptape Cloud bucket. Returns the asset's name, size, content type and timestamps. Use this to check a file exists.

    Inputs

    bucket_idstringrequired
    ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
    namestringrequired
    Asset name (path in the bucket). Example: faq.pdf.
  • griptape_bucket_assets_listList the files (assets) in a Griptape Cloud bucket, optionally by name prefix or suffix.Read-only

    List Bucket Assets

    List the files (assets) in a Griptape Cloud bucket, optionally by name prefix or suffix. Returns assets with name, size, content type and timestamps. Use this to browse a bucket.

    Inputs

    bucket_idstringrequired
    ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
    pageinteger
    Page number, starting at 1. Example: 1.
    page_sizeinteger
    Results per page. Example: 20.
    postfixstring
    Only assets whose name ends with this text. Example: .pdf.
    prefixstring
    Only assets whose name starts with this text. Example: faq/.
  • griptape_bucket_getGet one Griptape Cloud bucket.Read-only

    Get Bucket

    Get one Griptape Cloud bucket. Returns the bucket's name and timestamps. Use this for a bucket's details.

    Inputs

    bucket_idstringrequired
    ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
  • griptape_buckets_listList Griptape Cloud data buckets (file storage).Read-only

    List Buckets

    List Griptape Cloud data buckets (file storage). Returns buckets with ID, name and timestamps. Use this to find a bucket.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1.
    page_sizeinteger
    Results per page. Example: 20.
  • griptape_credit_balance_getGet the Griptape Cloud credit balance of your organization.Read-only

    Get Credit Balance

    Get the Griptape Cloud credit balance of your organization. Returns the remaining credits. Use this before running large jobs.

    Inputs

    This tool takes no inputs.

  • griptape_credit_transactions_listList Griptape Cloud credit transactions (purchases and usage).Read-only

    List Credit Transactions

    List Griptape Cloud credit transactions (purchases and usage). Returns transactions with amount, type and timestamp. Use this to audit credit spend.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1.
    page_sizeinteger
    Results per page. Example: 20.
  • griptape_deployment_getGet one Griptape Cloud deployment.Read-only

    Get Deployment

    Get one Griptape Cloud deployment. Returns the deployment's status, code source, logs location and timestamps. Use this to follow a build.

    Inputs

    deployment_idstringrequired
    ID of the deployment, from griptape_structure_deployments_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
  • griptape_event_getGet one event emitted by a Griptape Cloud structure run.Read-only

    Get Event

    Get one event emitted by a Griptape Cloud structure run. Returns the event's type, payload and timestamp. Use this for one event's full payload.

    Inputs

    event_idstringrequired
    ID of the event, from griptape_structure_run_events_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.