Maton

What is Maton Agent Toolkit?

The Maton Agent Toolkit is a TypeScript library designed to connect agent frameworks, such as Model Context Protocol (MCP), with Maton APIs. It allows for function calling to interact with various SaaS applications, enabling automation and data management across different platforms.

How to use Maton Agent Toolkit?

To use the Maton Agent Toolkit, you first need to obtain an API key from your Maton Dashboard. The toolkit can be installed via npm:

npm install @maton/agent-toolkit

For Model Context Protocol (MCP) integration, you can run the Maton MCP server using npx to set up API agents or specific API actions. For example, to set up all available HubSpot API actions:

npx -y @maton/mcp hubspot --actions=all --api-key=YOUR_MATON_API_KEY

You can also configure it for use with Claude Desktop by adding specific commands to your claude_desktop_config.json.

Key Features of Maton Agent Toolkit

Integration with Maton APIs: Seamlessly connects agent frameworks with Maton's extensive API functionalities.
Support for Model Context Protocol (MCP): Enables robust interaction with MCP for advanced agent capabilities.
Function Calling: Allows agents to perform specific actions within connected SaaS applications.
Wide Range of Supported Applications: Provides integrations with numerous popular SaaS tools.
TypeScript Support: Built with TypeScript, offering type safety and improved developer experience.

Use Cases of Maton Agent Toolkit

The Maton Agent Toolkit can be used for a variety of automation and data management tasks across different applications:

CRM Automation: Create, update, and manage contacts, deals, and other entities in HubSpot or Salesforce.
Project Management: Create and manage tasks in Asana or ClickUp, list projects, and track progress.
Cloud Storage Management: Interact with Google Drive and AWS S3 to create, list, and manage files and folders.
Email and Calendar Management: Automate email sending, draft creation, event scheduling, and calendar management with Google Mail, Outlook, and Google Calendar.
Marketing Automation: Manage campaigns and profiles in Klaviyo and Mailchimp.
Data Synchronization: Synchronize data across various platforms like Airtable and Google Sheets.
Customer Support: Manage customer interactions and data in platforms like Shopify and Stripe.

FAQ from Maton Agent Toolkit

Q: Do I need the source code to use the package? A: No, you only need the source code if you intend to modify the package. Otherwise, you can simply install it via npm.

Q: What are the requirements for using the Maton Agent Toolkit? A: Node.js version 18 or higher is required.

Q: How do I get my Maton API key? A: You can obtain your Maton API key from your Maton Dashboard at https://maton.ai/api-keys.

Q: What is Model Context Protocol (MCP)? A: The Model Context Protocol (MCP) is a framework supported by the Maton Agent Toolkit that facilitates advanced agent interactions and integrations. More details can be found at https://modelcontextprotocol.com/.

Maton Agent Toolkit

The Maton Agent Toolkit enables popular agent frameworks including Model Context Protocol (MCP) to integrate with Maton APIs through function calling. The library is not exhaustive of the entire Maton API. It includes support for Typescript.

The toolkit was inspired by Stripe Agent Toolkit, and its implementation shares similarities with the Stripe Agent Toolkit codebase.

Included below are basic instructions, but refer to the TypeScript package for more information.

To get started, get your API key in your Maton Dashboard and check out documentation.

TypeScript

Installation

You don't need this source code unless you want to modify the package. If you just want to use the package run:

npm install @maton/agent-toolkit

Requirements

Node 18+

Usage

Model Context Protocol

The Maton Agent Toolkit also supports the Model Context Protocol (MCP).

To run the Maton MCP server using npx, use the following command:

API Agent (Beta)

# To use API agent
npx -y @maton/mcp hubspot --agent --api-key=YOUR_MATON_API_KEY

API Action

# To set up all available API actions
npx -y @maton/mcp hubspot --actions=all --api-key=YOUR_MATON_API_KEY

# To set up all available API actions
npx -y @maton/mcp hubspot --actions=create-contact,list-contacts --api-key=YOUR_MATON_API_KEY

Replace YOUR_MATON_API_KEY with your actual Maton API key. Or, you could set the MATON_API_KEY in your environment variables. You can get your API key in your Maton Dashboard.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json. See here for more details.

{
  "mcpServers": {
    "maton": {
      "command": "npx",
      "args": [
        "-y",
        "@maton/mcp@latest",
        "hubspot",
        "--actions=all",
        "--api-key=YOUR_MATON_API_KEY"
      ]
    }
  }
}

Make sure to replace YOUR_MATON_API_KEY with your actual Maton API key. Alternatively, you could set the MATON_API_KEY in env variables. You can get your API key in your Maton Dashboard.

Available API actions

App	Action
`airtable`	`list-bases`
`airtable`	`list-records`
`airtable`	`list-tables`
`asana`	`create-task`
`asana`	`get-task`
`asana`	`list-projects`
`asana`	`list-tasks`
`asana`	`list-workspaces`
`aws`	`get-s3-object`
`aws`	`list-s3-buckets`
`aws`	`list-s3-objects`
`calendly`	`get-event`
`calendly`	`list-event-invitees`
`calendly`	`list-event-types`
`calendly`	`list-events`
`clickup`	`create-task`
`clickup`	`delete-task`
`clickup`	`get-task`
`clickup`	`list-folders`
`clickup`	`list-lists`
`clickup`	`list-spaces`
`clickup`	`list-tasks`
`clickup`	`list-workspaces`
`google-calendar`	`create-event`
`google-calendar`	`delete-event`
`google-calendar`	`get-calendar`
`google-calendar`	`get-event`
`google-calendar`	`list-calendars`
`google-calendar`	`list-events`
`google-calendar`	`update-event`
`google-docs`	`append-text`
`google-docs`	`create-document`
`google-docs`	`find-document`
`google-docs`	`get-document`
`google-drive`	`create-file`
`google-drive`	`create-folder`
`google-drive`	`delete-file`
`google-drive`	`find-file`
`google-drive`	`find-folder`
`google-drive`	`get-file`
`google-drive`	`list-files`
`google-mail`	`add-label-to-email`
`google-mail`	`create-draft`
`google-mail`	`find-email`
`google-mail`	`list-labels`
`google-mail`	`send-email`
`google-mail`	`remove-label-from-email`
`google-sheet`	`add-column`
`google-sheet`	`add-multiple-rows`
`google-sheet`	`clear-cell`
`google-sheet`	`clear-rows`
`google-sheet`	`create-spreadsheet`
`google-sheet`	`create-worksheet`
`google-sheet`	`delete-rows`
`google-sheet`	`delete-worksheet`
`google-sheet`	`find-row`
`google-sheet`	`get-cell`
`google-sheet`	`get-spreadsheet`
`google-sheet`	`get-values-in-range`
`google-sheet`	`list-worksheets`
`google-sheet`	`update-cell`
`google-sheet`	`update-multiple-rows`
`google-sheet`	`update-row`
`hubspot`	`create-contact`
`hubspot`	`get-contact`
`hubspot`	`list-contacts`
`hubspot`	`search-contacts`
`hubspot`	`merge-contacts`
`hubspot`	`update-contact`
`hubspot`	`delete-contact`
`hubspot`	`create-deal`
`hubspot`	`get-deal`
`hubspot`	`list-deals`
`hubspot`	`search-deals`
`hubspot`	`merge-deals`
`hubspot`	`update-deal`
`hubspot`	`delete-deal`
`jira`	`list-clouds`
`jira`	`get-issue`
`jira`	`list-issues`
`jira`	`add-comment-to-issue`
`jira`	`list-comments`
`jira`	`update-comment`
`jira`	`list-projects`
`jira`	`get-user`
`jira`	`list-users`
`jotform`	`list-forms`
`jotform`	`list-submissions`
`klaviyo`	`add-profiles-to-list`
`klaviyo`	`assign-template-to-campaign-message`
`klaviyo`	`create-campaign`
`klaviyo`	`create-list`
`klaviyo`	`create-profile`
`klaviyo`	`create-template`
`klaviyo`	`get-campaign-messages`
`klaviyo`	`get-campaign-send-job`
`klaviyo`	`get-campaigns`
`klaviyo`	`get-lists`
`klaviyo`	`get-profiles-for-list`
`klaviyo`	`get-profiles`
`klaviyo`	`get-templates`
`klaviyo`	`send-campaign`
`mailchimp`	`get-campaign`
`mailchimp`	`search-campaign`
`notion`	`create-page`
`notion`	`find-page`
`notion`	`get-page`
`outlook`	`create-draft`
`outlook`	`find-email`
`outlook`	`send-email`
`pipedrive`	`search-people`
`salesforce`	`create-contact`
`salesforce`	`get-contact`
`salesforce`	`list-contacts`
`shopify`	`create-order`
`shopify`	`get-order`
`shopify`	`list-orders`
`slack`	`list-channels`
`slack`	`list-messages`
`slack`	`list-replies`
`slack`	`send-message`
`stripe`	`create-customer`
`stripe`	`create-invoice-item`
`stripe`	`create-invoice`
`stripe`	`delete-customer`
`stripe`	`get-customer`
`stripe`	`get-invoice`
`stripe`	`list-customers`
`stripe`	`list-invoices`
`typeform`	`get-form`
`typeform`	`list-forms`
`typeform`	`list-responses`
`youtube`	`list-videos`
`youtube`	`search-videos`

Maton Overview