Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Zep

Scalekit connector
Open markdown

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

Tools
60
What they doRead · write · destructive
38 · 16 · 638 read16 write6 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 Zep connection

    In AgentKit > Connections, create a Zep 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 = 'zep'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Zep:', 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: 'zep_graph_lookup',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Zep 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
  • zep_edge_getGet one edge with its fact, source and target nodes and validity times.Read-only

    Get Edge

    Get one edge with its fact, source and target nodes and validity times. Returns the edge object. Get UUIDs from zep_edges_list.

    Inputs

    edge_uuidstringrequired
    UUID of the edge. Get it from zep_edges_list or zep_graph_edges_search. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
    graph_uuidstringrequired
    Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
  • zep_edges_listList a graph's edges (facts), a page at a time, optionally filtered.Read-only

    List Edges

    List a graph's edges (facts), a page at a time, optionally filtered. Returns edge objects with their fact, nodes and validity times. Use zep_graph_edges_search for a text query. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.

    Inputs

    graph_uuidstringrequired
    Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
    cursorstring
    Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
    filtersobject
    Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
    orderstring
    Sort direction: asc or desc (default desc). Example: desc.one of ascdesc
    order_bystring
    Sort key: uuid (default), created_at, or valid_at. Example: created_at.one of uuidcreated_atvalid_at
    page_sizeinteger
    Maximum number of items in one page. Defaults to 50. Example: 50.
  • zep_episode_getGet one episode with its content and processing status.Read-only

    Get Episode

    Get one episode with its content and processing status. Returns the episode object. Get UUIDs from zep_episodes_list.

    Inputs

    episode_uuidstringrequired
    UUID of the episode. Get it from zep_episodes_list. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
    graph_uuidstringrequired
    Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
  • zep_episodes_listList a graph's episodes, newest first, a page at a time.Read-only

    List Episodes

    List a graph's episodes, newest first, a page at a time. Returns episode objects with content and processing status. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.

    Inputs

    graph_uuidstringrequired
    Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
    cursorstring
    Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
    filtersobject
    Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
    orderstring
    Sort direction: asc or desc. Example: desc.one of ascdesc
    order_bystring
    Sort field. Example: created_at.one of created_atuuid
    page_sizeinteger
    Maximum number of items in one page. Defaults to 50. Example: 50.
  • zep_graph_context_getSearch a graph with a query and assemble the results into a context block for an LLM prompt.Read-only

    Assemble Graph Context

    Search a graph with a query and assemble the results into a context block for an LLM prompt. Returns the context string. Use the zep_graph_*_search tools for raw results and zep_thread_context_get for a thread. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.

    Inputs

    graph_uuidstringrequired
    Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
    querystringrequired
    Natural-language search query, for example What plan is Jane on? Example: What plan is Jane on?.
    filtersobject
    Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
    include_resultsboolean
    When true, includes the raw graph results selected for the context block. Example: true.
    max_charactersinteger
    The maximum number of characters in the assembled context block. Example: 10.
    recency_biasstring
    Adjusts result selection to favor more recent graph data. Example: off.one of offmildstrong
    template_uuidstring
    The UUID of a context template used to render the context block. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
  • zep_graph_getGet one graph by UUID.Read-only

    Get Graph

    Get one graph by UUID. Returns the graph with its name, description and owner. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.

    Inputs

    graph_uuidstringrequired
    Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.