What is Ai

Ampersand AI is an official SDK designed for developers to create AI agents that can integrate with various SaaS tools, enhancing their functionality and user experience.

Use cases

Use cases include automating customer support tasks, managing client records, and enhancing data interactions within SaaS platforms.

How to use

To use the Ampersand AI SDK, install it via npm, yarn, or pnpm. Import the necessary modules in your project, and configure your AI agent to utilize the provided tools for managing records and interactions.

Key features

Key features include seamless integration with popular agent frameworks, tools for creating and updating records, and comprehensive documentation to assist developers.

Where to use

Ampersand AI can be used in B2B applications where AI agents need to interact with customer SaaS tools, improving automation and efficiency in business processes.

Official Ampersand AI SDKs

This repo contains the official Ampersand AI SDK and the offical MCP server for Ampersand.

• AI SDK - Official Ampersand AI SDK that exposes tools for your AI agents to manage and interact with integrations with your customer’s SaaS tools.
• MCP server - Official Ampersand MCP server that exposes the tools from the Ampersand AI SDK.

The examples directory contains examples of how to use the AI SDK with popular agent frameworks.

Ampersand is a platform for AI builders to add B2B SaaS integrations to their agentic apps. To learn more, visit our website.

Ampersand AI SDK

Installation

npm install @amp-labs/ai
# or
yarn add @amp-labs/ai
# or
pnpm add @amp-labs/ai

Usage

The SDK provides several modules that can be used depending on your framework preference:

Using with Vercel AI SDK

import { createRecord, updateRecord } from "@amp-labs/ai/aisdk";

// Use in your AI agent configuration
const tools = [createRecord, updateRecord];

Using with Mastra

import { createRecord, updateRecord } from "@amp-labs/ai/mastra";

// Use in your Mastra workflow
const tools = [createRecord, updateRecord];

Ampersand MCP Server

Connect your agents to the 150+ connectors we offer at Ampersand via this multi-tenant MCP server. We expose the primitives we offer on the Ampersand platform as native tools here.

Connect to the remote MCP server

Add the following in your mcp.json in Cursor IDE or claude_desktop_config.json when using Claude desktop.

When running the server in SSE mode

If your MCP client supports headers:

{
  "mcpServers": {
    "@amp-labs/mcp-server": {
      "url": "https://mcp.withampersand.com/v1/sse?project=<AMPERSAND_PROJECT_ID>&integrationName=<AMPERSAND_INTEGRATION_NAME>&groupRef=<AMPERSAND_GROUP_REF>",
      "headers": {
        "x-api-key": "<AMPERSAND_API_KEY>"
      }
    }
  }
}

If your MCP client does not support headers, you can pass the API key in the query param:

{
  "mcpServers": {
    "@amp-labs/mcp-server": {
      "url": "https://mcp.withampersand.com/v1/sse?apiKey=<AMPERSAND_API_KEY>&project=<AMPERSAND_PROJECT_ID>&integrationName=<AMPERSAND_INTEGRATION_NAME>&groupRef=<AMPERSAND_GROUP_REF>"
    }
  }
}

When running the server in stdio mode

{
  "mcpServers": {
    "@amp-labs/mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@amp-labs/mcp-server@latest",
        "--transport",
        "stdio",
        "--project",
        "<AMPERSAND_PROJECT_ID>",
        "--integrationName",
        "<AMPERSAND_INTEGRATION_NAME>",
        "--groupRef",
        "<AMPERSAND_GROUP_REF>"
      ],
      "env": {
        "AMPERSAND_API_KEY": "<AMPERSAND_API_KEY>"
      }
    }
  }
}

Connect to the local MCP server

Please refer to the mcp-server README for more information.

License

This project is licensed under the MIT license.

See LICENSE for more information.

Contributing

We welcome contributions! Please refer to the CONTRIBUTING.md file for more information.