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