# How to integrate Klipfolio MCP with Mastra AI

```json
{
  "title": "How to integrate Klipfolio MCP with Mastra AI",
  "toolkit": "Klipfolio",
  "toolkit_slug": "klipfolio",
  "framework": "Mastra AI",
  "framework_slug": "mastra-ai",
  "url": "https://composio.dev/toolkits/klipfolio/framework/mastra-ai",
  "markdown_url": "https://composio.dev/toolkits/klipfolio/framework/mastra-ai.md",
  "updated_at": "2026-05-12T10:16:55.357Z"
}
```

## Introduction

This guide walks you through connecting Klipfolio to Mastra AI using the Composio tool router. By the end, you'll have a working Klipfolio agent that can create a new dashboard for marketing kpis, list all available data sources in your account, append this week's sales csv to data source through natural language commands.
This guide will help you understand how to give your Mastra AI agent real control over a Klipfolio account through Composio's Klipfolio MCP server.
Before we dive in, let's take a quick look at the key ideas and tools involved.

## Also integrate Klipfolio with

- [OpenAI Agents SDK](https://composio.dev/toolkits/klipfolio/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/klipfolio/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/klipfolio/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/klipfolio/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/klipfolio/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/klipfolio/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/klipfolio/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/klipfolio/framework/cli)
- [Google ADK](https://composio.dev/toolkits/klipfolio/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/klipfolio/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/klipfolio/framework/ai-sdk)
- [LlamaIndex](https://composio.dev/toolkits/klipfolio/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/klipfolio/framework/crew-ai)

## TL;DR

Here's what you'll learn:
- Set up your environment so Mastra, OpenAI, and Composio work together
- Create a Tool Router session in Composio that exposes Klipfolio tools
- Connect Mastra's MCP client to the Composio generated MCP URL
- Fetch Klipfolio tool definitions and attach them as a toolset
- Build a Mastra agent that can reason, call tools, and return structured results
- Run an interactive CLI where you can chat with your Klipfolio agent

## What is Mastra AI?

Mastra AI is a TypeScript framework for building AI agents with tool support. It provides a clean API for creating agents that can use external services through MCP.
Key features include:
- MCP Client: Built-in support for Model Context Protocol servers
- Toolsets: Organize tools into logical groups
- Step Callbacks: Monitor and debug agent execution
- OpenAI Integration: Works with OpenAI models via @ai-sdk/openai

## What is the Klipfolio MCP server, and what's possible with it?

The Klipfolio MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Klipfolio account. It provides structured and secure access to your dashboards and data sources, so your agent can perform actions like creating dashboards, updating data sources, retrieving analytics, and managing visualizations on your behalf.
- Effortless dashboard creation and management: Ask your agent to create new dashboards (tabs), organize visualizations, or fetch detailed information about existing dashboards for instant business insights.
- Comprehensive data source handling: Let your agent list, create, refresh, or delete data sources, ensuring your reports are always up to date and data flows smoothly.
- Automated data updating: Instruct your agent to append fresh data to data sources or trigger refreshes across multiple sources simultaneously, keeping analytics current without manual effort.
- Visualization and klip management: Retrieve a list of all your klips (visual components), enabling your agent to analyze, summarize, or reference the data visualizations you rely on most.
- User profile and account verification: Have the agent check authentication or pull user profile details, helping you audit access and monitor account activity with ease.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `KLIPFOLIO_ASSIGN_USER_ROLE` | Assign User Role | Tool to assign a role to a user in Klipfolio. Use when you need to grant role-based permissions to a specific user. Requires both user ID and role ID. |
| `KLIPFOLIO_CREATE_DATA_SOURCE` | Create Data Source | This tool creates a new data source in Klipfolio. It uses the POST /datasources endpoint to add a data source with required parameters (name, format, connector, endpointUrl) and optional parameters (description, refreshInterval, method, additionalProperties). |
| `KLIPFOLIO_CREATE_DATA_SOURCE_INSTANCE` | Create Data Source Instance | Tool to create a new data source instance based on an existing data source in Klipfolio. Use when you need to instantiate a data source with specific properties or configuration. Requires datasource.create permission. |
| `KLIPFOLIO_CREATE_GROUP` | Create Group | Tool to create a new group in Klipfolio. Use when you need to organize users into groups for managing permissions and access control. |
| `KLIPFOLIO_CREATE_ROLE` | Create Role | Tool to create a new role in Klipfolio with optional permissions. Use when you need to define a new role with specific access rights. Requires 'user.manage' permission. |
| `KLIPFOLIO_CREATE_TAB` | Create Tab (Dashboard) | This tool creates a new tab (dashboard) in Klipfolio. A tab serves as a container for organizing and displaying Klips (data visualizations) in a meaningful way. The tool allows users to set up a new dashboard with specific properties and configurations. |
| `KLIPFOLIO_CREATE_USER` | Create User | Tool to create a new user in Klipfolio with optional roles and client association. Use when you need to add a new user account. Requires 'user.manage' permission. |
| `KLIPFOLIO_DELETE_DATA_SOURCE` | Delete Data Source | This tool permanently removes a specified data source from the Klipfolio account. This operation is destructive and cannot be undone. The data source must not be currently in use, and proper permissions are required. |
| `KLIPFOLIO_DELETE_DATA_SOURCE_INSTANCE_PROPERTY` | Delete Data Source Instance Property | Tool to delete a property from a data source instance in Klipfolio. Use when you need to remove custom properties or metadata from a specific data source instance. |
| `KLIPFOLIO_DELETE_DATA_SOURCE_PROPERTY` | Delete Data Source Property | Tool to delete a property from a data source in Klipfolio. Use when you need to remove custom properties or metadata from a specific data source. |
| `KLIPFOLIO_DELETE_DATA_SOURCE_SHARE_RIGHT` | Delete Data Source Share Right | Tool to delete a data source share right for a specific user or group. Use when you need to revoke access permissions from a data source. |
| `KLIPFOLIO_DELETE_GROUP` | Delete Group | Tool to permanently delete a specified group from the Klipfolio account. Use when you need to remove a user group. This operation is destructive and cannot be undone. Proper permissions are required. |
| `KLIPFOLIO_DELETE_ROLE` | Delete Role | Tool to delete a role from Klipfolio. Use when you need to permanently remove a role from the account. This operation is destructive and cannot be undone. |
| `KLIPFOLIO_DISABLE_DATA_SOURCE` | Disable Data Source | Tool to disable a data source in Klipfolio. Use when you need to temporarily stop a data source from refreshing without deleting it. The data source can be re-enabled later if needed. |
| `KLIPFOLIO_ENABLE_DATA_SOURCE` | Enable Data Source | Tool to enable a disabled data source in Klipfolio. Use when you need to reactivate a data source that was previously disabled. Note: The data source must be in disabled state before it can be enabled, otherwise a 403 error will be returned. |
| `KLIPFOLIO_GET_DASHBOARD` | Get Dashboard Details | This tool retrieves detailed information about a specific dashboard (formerly known as tab) in Klipfolio. It allows users to obtain comprehensive information including properties, settings, and metadata of the dashboard. |
| `KLIPFOLIO_GET_DATA_SOURCE` | Get Data Source Details | Tool to retrieve detailed information about a specific data source in Klipfolio. Use when you need to get configuration details, refresh settings, or metadata for a data source. |
| `KLIPFOLIO_GET_DATA_SOURCE_INSTANCE2` | Get Data Source Instance Details | Tool to retrieve detailed information about a specific data source instance in Klipfolio. Use when you need to fetch metadata and status for a data source instance. |
| `KLIPFOLIO_GET_DATA_SOURCE_INSTANCE_DATA` | Get Data Source Instance Data | Tool to retrieve the actual data from a specific data source instance in Klipfolio. Use when you need to access the raw data stored in a data source instance. |
| `KLIPFOLIO_GET_DATA_SOURCE_INSTANCE_PROPERTIES` | Get Data Source Instance Properties | Tool to retrieve configuration properties for a specific data source instance in Klipfolio. Use when you need to inspect how the API connects to a data source instance (endpoint URL, method, headers, etc.). |
| `KLIPFOLIO_GET_DATA_SOURCE_PROPERTIES` | Get Data Source Properties | Tool to retrieve properties for a specific data source in Klipfolio by its ID. Use when you need to get configuration details of a data source such as endpoint URLs, authentication tokens, or custom properties. |
| `KLIPFOLIO_GET_DATA_SOURCE_SHARE_RIGHTS` | Get Data Source Share Rights | Tool to retrieve sharing permissions for a specific data source in Klipfolio. Returns both group-level and user-level access rights, including edit permissions for each. |
| `KLIPFOLIO_GET_GROUP` | Get Group Details | Tool to retrieve detailed information about a specific group in Klipfolio. Use when you need to get group properties such as name, description, member count, and optionally the list of members. |
| `KLIPFOLIO_GET_GROUP_DEFAULT_TABS` | Get Group Default Tabs | Tool to retrieve the list of default tabs (dashboards) for a specific group. Use when you need to see which dashboards are set as defaults for a user group. |
| `KLIPFOLIO_GET_GROUP_USERS` | Get Group Users | Tool to retrieve all users belonging to a specific group in Klipfolio. Use when you need to list members of a group. |
| `KLIPFOLIO_GET_KLIPS` | Get Klips | This tool retrieves a list of all Klips accessible to the authenticated user. Klips are visualization components in Klipfolio that display data in various formats like charts, tables, or metrics. |
| `KLIPFOLIO_GET_PROFILE` | Get User Profile | This tool is used to retrieve the authenticated user's profile information and test the authentication status. It verifies API connectivity and access permissions by returning profile details such as User ID, Username, Email, Company information, Role and permissions, and Account status. |
| `KLIPFOLIO_GET_ROLE` | Get Role Details | Tool to retrieve detailed information about a specific role in Klipfolio. Use when you need to check role permissions, view role assignments, or understand role configuration. |
| `KLIPFOLIO_GET_ROLE_PERMISSIONS` | Get Role Permissions | Tool to retrieve the list of permissions assigned to a specific role in Klipfolio. Use when you need to view what permissions a role has, such as account.api, admin.client, client.access, dashboard permissions, datasource permissions, klip permissions, tab permissions, or user.manage. |
| `KLIPFOLIO_GET_ROLE_USERS` | Get Role Users | Tool to retrieve all users associated with a specific role in Klipfolio. Use when you need to see which users are assigned to a role. Requires user.manage permission. |
| `KLIPFOLIO_GET_USER` | Get User Details | Tool to retrieve detailed information about a specific user in Klipfolio. Use when you need to get user properties such as name, email, login history, group memberships, and role assignments. |
| `KLIPFOLIO_GET_USER_GROUPS` | Get User Groups | Tool to retrieve all groups that a specific user belongs to in Klipfolio. Use when you need to check group membership for a user. |
| `KLIPFOLIO_GET_USER_PROPERTIES` | Get User Properties | Tool to retrieve custom properties associated with a specific user in Klipfolio. Use when you need to access user-defined key-value pairs stored as user properties. |
| `KLIPFOLIO_GET_USER_ROLES` | Get User Roles | Tool to retrieve all roles assigned to a specific user in Klipfolio. Use when you need to check what permissions and access levels a user has through their role assignments. |
| `KLIPFOLIO_GET_USER_TAB_INSTANCES` | Get User Tab Instances | Tool to retrieve all tab instances associated with a specific user. Use when you need to view dashboard copies assigned to a user's account. Tab instances represent copies of tabs in a user's account. |
| `KLIPFOLIO_LIST_DATA_SOURCE_INSTANCES` | List Data Source Instances | Tool to retrieve all data source instances accessible to the authenticated user. Use when you need to list, query, or monitor data source instances with optional filtering by client or data source. |
| `KLIPFOLIO_LIST_DATA_SOURCES` | List All Data Sources | This tool retrieves a list of all data sources associated with an authenticated Klipfolio account. It supports optional query parameters for pagination (limit and offset) and filtering by client_id. The response includes details for each data source such as id, name, description, format, connector type, refresh interval, and timestamps. |
| `KLIPFOLIO_LIST_GROUPS` | List All Groups | Tool to retrieve all groups from a Klipfolio account. Use when you need to list groups for access management or filtering purposes. Supports filtering by client_id or external_id, and can include member data when used with external_id. |
| `KLIPFOLIO_LIST_ROLES` | List All Roles | Tool to retrieve all roles in the company. Use when you need to view available roles, check role configurations, or identify role IDs for permission management. |
| `KLIPFOLIO_LIST_USERS` | List All Users | Tool to retrieve all users in the company. Use when you need to view all users, search for specific users by email or external ID, or get user details for access management. |
| `KLIPFOLIO_REFRESH_DATA_SOURCE_INSTANCE` | Refresh Data Source Instance | Tool to manually refresh a data source instance in Klipfolio. Use when you need to update the data from its source immediately rather than waiting for the scheduled refresh interval. |
| `KLIPFOLIO_REFRESH_MULTIPLE_DATA_SOURCES` | Refresh Multiple Data Sources | This tool allows users to refresh multiple data sources in Klipfolio simultaneously. It queues the specified data sources for refresh, updating their data from their respective sources. At least one data source ID must be provided. |
| `KLIPFOLIO_RESEND_USER_INVITE` | Resend User Invite | Tool to resend a user invitation email in Klipfolio. Use when you need to resend an invitation to a user who has not yet accepted their account invite. |
| `KLIPFOLIO_RESET_USER_PASSWORD` | Reset User Password | Tool to reset a user's password in Klipfolio. Use when you need to trigger a password reset for a specific user account. This will send a password reset link to the user. |
| `KLIPFOLIO_UPDATE_DATA_SOURCE` | Update Data Source | This tool allows you to replace/update the data in an existing Klipfolio data source. It completely replaces the existing data with new data in the specified data source. The tool requires new data (in plain-text or CSV format) to be provided and updates the data source accordingly. |
| `KLIPFOLIO_UPDATE_DATA_SOURCE_INSTANCE_PROPERTIES` | Update Data Source Instance Properties | Tool to update custom properties on a Klipfolio data source instance. Use when you need to set or modify key-value property pairs on an existing data source instance. |
| `KLIPFOLIO_UPDATE_DATA_SOURCE_METADATA` | Update Data Source Metadata | Tool to update metadata (name, description, refresh_interval) of an existing data source. Use when you need to modify properties of a data source without changing its actual data. |
| `KLIPFOLIO_UPDATE_DATA_SOURCE_PROPERTIES` | Update Data Source Properties | Tool to update custom properties for a data source in Klipfolio. Use when you need to modify metadata or configuration properties associated with a specific data source. |
| `KLIPFOLIO_UPDATE_DATA_SOURCE_SHARE_RIGHTS` | Update Data Source Share Rights | Tool to update data source share rights in Klipfolio. Use when you need to grant or modify access permissions for users or groups to a specific data source. This allows you to control who can view or edit a data source by specifying user IDs and group IDs with their respective permissions. |
| `KLIPFOLIO_UPDATE_USER_PROPERTIES` | Update User Properties | Tool to update custom properties for a user in Klipfolio. Use when you need to modify metadata or configuration properties associated with a specific user account. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Klipfolio MCP server is an implementation of the Model Context Protocol that connects your AI agent to Klipfolio. It provides structured and secure access so your agent can perform Klipfolio operations on your behalf through a secure, permission-based interface.
With Composio's managed implementation, you don't have to create your own developer app. For production, if you're building an end product, we recommend using your own credentials. The managed server helps you prototype fast and go from 0-1 faster.

## Step-by-step Guide

### 1. Prerequisites

Before starting, make sure you have:
- Node.js 18 or higher
- A Composio account with an active API key
- An OpenAI API key
- Basic familiarity with TypeScript

### 1. Getting API Keys for OpenAI and Composio

OpenAI API Key
- Go to the [OpenAI dashboard](https://platform.openai.com/settings/organization/api-keys) and create an API key.
- You need credits or a connected billing setup to use the models.
- Store the key somewhere safe.
Composio API Key
- Log in to the [Composio dashboard](https://dashboard.composio.dev?utm_source=toolkits&utm_medium=framework_docs).
- Go to Settings and copy your API key.
- This key lets your Mastra agent talk to Composio and reach Klipfolio through MCP.

### 2. Install dependencies

Install the required packages.
What's happening:
- @composio/core is the Composio SDK for creating MCP sessions
- @mastra/core provides the Agent class
- @mastra/mcp is Mastra's MCP client
- @ai-sdk/openai is the model wrapper for OpenAI
- dotenv loads environment variables from .env
```bash
npm install @composio/core @mastra/core @mastra/mcp @ai-sdk/openai dotenv
```

### 3. Set up environment variables

Create a .env file in your project root.
What's happening:
- COMPOSIO_API_KEY authenticates your requests to Composio
- COMPOSIO_USER_ID tells Composio which user this session belongs to
- OPENAI_API_KEY lets the Mastra agent call OpenAI models
```bash
COMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key_here
```

### 4. Import libraries and validate environment

What's happening:
- dotenv/config auto loads your .env so process.env.* is available
- openai gives you a Mastra compatible model wrapper
- Agent is the Mastra agent that will call tools and produce answers
- MCPClient connects Mastra to your Composio MCP server
- Composio is used to create a Tool Router session
```typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey as string,
});
```

### 5. Create a Tool Router session for Klipfolio

What's happening:
- create spins up a short-lived MCP HTTP endpoint for this user
- The toolkits array contains "klipfolio" for Klipfolio access
- session.mcp.url is the MCP URL that Mastra's MCPClient will connect to
```typescript
async function main() {
  const session = await composio.create(
    composioUserID as string,
    {
      toolkits: ["klipfolio"],
    },
  );

  const composioMCPUrl = session.mcp.url;
  console.log("Klipfolio MCP URL:", composioMCPUrl);
```

### 6. Configure Mastra MCP client and fetch tools

What's happening:
- MCPClient takes an id for this client and a list of MCP servers
- The headers property includes the x-api-key for authentication
- getTools fetches the tool definitions exposed by the Klipfolio toolkit
```typescript
const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      nasdaq: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

console.log("Fetching MCP tools from Composio...");
const composioTools = await mcpClient.getTools();
console.log("Number of tools:", Object.keys(composioTools).length);
```

### 7. Create the Mastra agent

What's happening:
- Agent is the core Mastra agent
- name is just an identifier for logging and debugging
- instructions guide the agent to use tools instead of only answering in natural language
- model uses openai("gpt-5") to configure the underlying LLM
```typescript
const agent = new Agent({
    name: "klipfolio-mastra-agent",
    instructions: "You are an AI agent with Klipfolio tools via Composio.",
    model: "openai/gpt-5",
  });
```

### 8. Set up interactive chat interface

What's happening:
- messages keeps the full conversation history in Mastra's expected format
- agent.generate runs the agent with conversation history and Klipfolio toolsets
- maxSteps limits how many tool calls the agent can take in a single run
- onStepFinish is a hook that prints intermediate steps for debugging
```typescript
let messages: AiMessageType[] = [];

console.log("Chat started! Type 'exit' or 'quit' to end.\n");

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: "> ",
});

rl.prompt();

rl.on("line", async (userInput: string) => {
  const trimmedInput = userInput.trim();

  if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
    console.log("\nGoodbye!");
    rl.close();
    process.exit(0);
  }

  if (!trimmedInput) {
    rl.prompt();
    return;
  }

  messages.push({
    id: crypto.randomUUID(),
    role: "user",
    content: trimmedInput,
  });

  console.log("\nAgent is thinking...\n");

  try {
    const response = await agent.generate(messages, {
      toolsets: {
        klipfolio: composioTools,
      },
      maxSteps: 8,
    });

    const { text } = response;

    if (text && text.trim().length > 0) {
      console.log(`Agent: ${text}\n`);
        messages.push({
          id: crypto.randomUUID(),
          role: "assistant",
          content: text,
        });
      }
    } catch (error) {
      console.error("\nError:", error);
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    console.log("\nSession ended.");
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});
```

## Complete Code

```typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({ apiKey: composioAPIKey as string });

async function main() {
  const session = await composio.create(composioUserID as string, {
    toolkits: ["klipfolio"],
  });

  const composioMCPUrl = session.mcp.url;

  const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      klipfolio: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

  const composioTools = await mcpClient.getTools();

  const agent = new Agent({
    name: "klipfolio-mastra-agent",
    instructions: "You are an AI agent with Klipfolio tools via Composio.",
    model: "openai/gpt-5",
  });

  let messages: AiMessageType[] = [];

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: "> ",
  });

  rl.prompt();

  rl.on("line", async (input: string) => {
    const trimmed = input.trim();
    if (["exit", "quit"].includes(trimmed.toLowerCase())) {
      rl.close();
      return;
    }

    messages.push({ id: crypto.randomUUID(), role: "user", content: trimmed });

    const { text } = await agent.generate(messages, {
      toolsets: { klipfolio: composioTools },
      maxSteps: 8,
    });

    if (text) {
      console.log(`Agent: ${text}\n`);
      messages.push({ id: crypto.randomUUID(), role: "assistant", content: text });
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main();
```

## Conclusion

You've built a Mastra AI agent that can interact with Klipfolio through Composio's Tool Router.
You can extend this further by:
- Adding other toolkits like Gmail, Slack, or GitHub
- Building a web-based chat interface around this agent
- Using multiple MCP endpoints to enable cross-app workflows

## How to build Klipfolio MCP Agent with another framework

- [OpenAI Agents SDK](https://composio.dev/toolkits/klipfolio/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/klipfolio/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/klipfolio/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/klipfolio/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/klipfolio/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/klipfolio/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/klipfolio/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/klipfolio/framework/cli)
- [Google ADK](https://composio.dev/toolkits/klipfolio/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/klipfolio/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/klipfolio/framework/ai-sdk)
- [LlamaIndex](https://composio.dev/toolkits/klipfolio/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/klipfolio/framework/crew-ai)

## Related Toolkits

- [Excel](https://composio.dev/toolkits/excel) - Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management.
- [21risk](https://composio.dev/toolkits/_21risk) - 21RISK is a web app built for easy checklist, audit, and compliance management. It streamlines risk processes so teams can focus on what matters.
- [Abstract](https://composio.dev/toolkits/abstract) - Abstract provides a suite of APIs for automating data validation and enrichment tasks. It helps developers streamline workflows and ensure data quality with minimal effort.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Agenty](https://composio.dev/toolkits/agenty) - Agenty is a web scraping and automation platform for extracting data and automating browser tasks—no coding needed. It streamlines data collection, monitoring, and repetitive online actions.
- [Ambee](https://composio.dev/toolkits/ambee) - Ambee is an environmental data platform providing real-time, hyperlocal APIs for air quality, weather, and pollen. Get precise environmental insights to power smarter decisions in your apps and workflows.
- [Ambient weather](https://composio.dev/toolkits/ambient_weather) - Ambient Weather is a platform for personal weather stations with a robust API for accessing local, real-time, and historical weather data. Get detailed environmental insights directly from your own sensors for smarter apps and automations.
- [Anonyflow](https://composio.dev/toolkits/anonyflow) - Anonyflow is a service for encryption-based data anonymization and secure data sharing. It helps organizations meet GDPR, CCPA, and HIPAA data privacy compliance requirements.
- [Api ninjas](https://composio.dev/toolkits/api_ninjas) - Api ninjas offers 120+ public APIs spanning categories like weather, finance, sports, and more. Developers use it to supercharge apps with real-time data and actionable endpoints.
- [Api sports](https://composio.dev/toolkits/api_sports) - Api sports is a comprehensive sports data platform covering 2,000+ competitions with live scores and 15+ years of stats. Instantly access up-to-date sports information for analysis, apps, or chatbots.
- [Apify](https://composio.dev/toolkits/apify) - Apify is a cloud platform for building, deploying, and managing web scraping and automation tools called Actors. It lets you automate data extraction and workflow tasks at scale—no infrastructure headaches.
- [Autom](https://composio.dev/toolkits/autom) - Autom is a lightning-fast search engine results data platform for Google, Bing, and Brave. Developers use it to access fresh, low-latency SERP data on demand.
- [Beaconchain](https://composio.dev/toolkits/beaconchain) - Beaconchain is a real-time analytics platform for Ethereum 2.0's Beacon Chain. It provides detailed insights into validators, blocks, and overall network performance.
- [Big data cloud](https://composio.dev/toolkits/big_data_cloud) - BigDataCloud provides APIs for geolocation, reverse geocoding, and address validation. Instantly access reliable location intelligence to enhance your applications and workflows.
- [Bigpicture io](https://composio.dev/toolkits/bigpicture_io) - BigPicture.io offers APIs for accessing detailed company and profile data. Instantly enrich your applications with up-to-date insights on 20M+ businesses.
- [Bitquery](https://composio.dev/toolkits/bitquery) - Bitquery is a blockchain data platform offering indexed, real-time, and historical data from 40+ blockchains via GraphQL APIs. Get unified, reliable access to complex on-chain data for analytics, trading, and research.
- [Brightdata](https://composio.dev/toolkits/brightdata) - Brightdata is a leading web data platform offering advanced scraping, SERP APIs, and anti-bot tools. It lets you collect public web data at scale, bypassing blocks and friction.
- [Builtwith](https://composio.dev/toolkits/builtwith) - BuiltWith is a web technology profiler that uncovers the technologies powering any website. Gain actionable insights into analytics, hosting, and content management stacks for smarter research and lead generation.
- [Byteforms](https://composio.dev/toolkits/byteforms) - Byteforms is an all-in-one platform for creating forms, managing submissions, and integrating data. It streamlines workflows by centralizing form data collection and automation.
- [Cabinpanda](https://composio.dev/toolkits/cabinpanda) - Cabinpanda is a data collection platform for building and managing online forms. It helps streamline how you gather, organize, and analyze responses.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Klipfolio MCP?

With a standalone Klipfolio MCP server, the agents and LLMs can only access a fixed set of Klipfolio tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Klipfolio and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Mastra AI?

Yes, you can. Mastra AI fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Klipfolio tools.

### Can I manage the permissions and scopes for Klipfolio while using Tool Router?

Yes, absolutely. You can configure which Klipfolio scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Klipfolio data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
