# How to connect Rulebricks with ChatGPT

```json
{
  "title": "How to connect Rulebricks with ChatGPT",
  "toolkit": "Rulebricks",
  "toolkit_slug": "rulebricks",
  "framework": "ChatGPT",
  "framework_slug": "chatgpt",
  "url": "https://composio.dev/toolkits/rulebricks/framework/chatgpt",
  "markdown_url": "https://composio.dev/toolkits/rulebricks/framework/chatgpt.md",
  "updated_at": "2026-11-19T05:35:44.067Z"
}
```

## Introduction

### How to connect Rulebricks MCP with ChatGPT
[ChatGPT](https://chatgpt.com/) can take action across your apps and files, stay with a project for hours, and turn a goal into finished materials like sheets, slides, and docs, not just answers.
In this guide, I will explain the easiest and most secure way to connect your Rulebricks account to ChatGPT via Composio Connect, so it can execute decision flows, test business rules, inspect results, publish versions, and manage deployments through natural language commands without ever putting your account credentials at risk.
For exact tool slugs and parameter tables, see the [tool catalog in the Composio docs](https://docs.composio.dev/toolkits/rulebricks).

## Also integrate Rulebricks with

- [Claude Cowork](https://composio.dev/toolkits/rulebricks/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/rulebricks/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/rulebricks/framework/atomic-agent)

## TL;DR

### Why use Composio over default connectors?
- Apps with read and write access. Default connectors mostly can read your data. Composio's Rulebricks integration lets ChatGPT take actions like creating drafts, sending updates, labeling records, and more.
- 1,700+ SaaS toolkits out of the box. Composio gives you instant access to a vast catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
- One MCP server for every app. Connect any of your applications on demand through a single endpoint, rather than juggling a separate server for each app.
- Smart, context-aware tool loading. Unlike traditional MCP servers that dump every available tool into the LLM context window, Composio searches for and loads only the tools relevant to the task at hand.
- Cross-app automation. Chain actions across multiple apps in a single run - fetch a thread, summarize it in Notion, and post highlights to Slack without leaving the conversation.

## Connect Rulebricks to ChatGPT

### Prerequisites
- A ChatGPT account. We will use the [ChatGPT desktop app](https://openai.com/chatgpt/download/), and the steps are the same on the web.
- Access to the Rulebricks workspace you want to connect.
- [Composio plugin](https://dashboard.composio.dev/login?cta_placement=toolkit-framework-chatgpt-composio-connect&next=%2F~%2Forg%2Fconnect%2Fclients%2Fchatgpt).
Note: Composio connects through OAuth. You will be asked to sign in and approve specific permissions. Review the permission screen carefully if you are using a work account.
### Step-by-step: Connect Rulebricks to ChatGPT
### 1. Install the Composio plugin
Click the button. ChatGPT opens the Composio plugin page. Click Install plugin.
[Install in ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6a58503580c08191b78cc5bdaf4eba6e)
You can also find it inside ChatGPT: go to Settings, open Plugins, search the marketplace for Composio, and click Install plugin.
### 2. Authenticate
After you install, ChatGPT asks you to authenticate with Composio. Log in and click Allow access to authorize ChatGPT to use your Composio account.
### 3. Start using Composio
That is it. Composio tools are now available in ChatGPT. Type @Composio followed by your request, for example @Composio find unread Rulebricks messages and summarize them, and it will run the actions you authorize. On first use it asks you to authorize Rulebricks.
### Option 2: Add Composio as an MCP server
If you cannot use the plugin marketplace, add Composio as a custom MCP server instead.
### 1. Open the MCP settings
In ChatGPT, go to Settings and open the Plugins section. Inside the Plugins page, click the MCP tab.
### 2. Add the server
Click Add server. In the Name field enter Composio, for Type select Streamable HTTP, and in the URL field paste the Composio MCP server URL:

```bash
https://connect.composio.dev/mcp
```

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

The Rulebricks MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Rulebricks account. It provides structured and secure access to rules, decision flows, contexts, tests, and workspace assets, so your agent can create and update decision logic, test rules and flows, execute published decisions, and manage context data on your behalf.
- Decision rule and flow management: Have your agent import new rules or flows, update existing decision logic, export assets for reuse, and remove rules or flows you no longer need.
- Rule and flow execution: Direct your agent to run published rules, process bulk inputs, execute flows, or run several assets in parallel for business decisions.
- Testing and decision monitoring: Let the agent create and list saved tests for rules and flows, count decision logs using filters, and check current Rulebricks usage.
- Context and relationship management: Instruct your agent to create, inspect, update through bulk submissions, cascade, and delete contexts and their instances, while managing relationships between contexts.
- Workspace organization: Have your agent list and create folders, inspect workspace objects, export related assets, and import an asset manifest containing rules, flows, contexts, and values.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `RULEBRICKS_BULK_SUBMIT_CONTEXT_DATA` | Bulk Submit Context Data | Merge a non-empty batch into a Rulebricks context and execute ready bound rules or flows. External effects and partial writes may occur; retrying after an uncertain response can repeat effects. Returns per-instance outcomes. |
| `RULEBRICKS_CASCADE_CONTEXT_INSTANCE` | Cascade Context Instance | Re-evaluate registered pending rule and flow work for a Rulebricks context instance after dependencies may have become available. Flows may invoke external actions, and retrying an uncertain request can repeat their effects. |
| `RULEBRICKS_COUNT_DECISION_LOGS` | Count Decision Logs | Count decision logs matching asset, status, trace, payload-content, or time-range filters without returning log payloads. |
| `RULEBRICKS_CREATE_ASSET_TEST` | Create Asset Test | Create a saved test case for a Rulebricks rule or flow with an input, expected response, comparison policy, and criticality. |
| `RULEBRICKS_CREATE_CONTEXT` | Create Context | Create a Rulebricks context with stored and derived fields, an identity fact, retention settings, and access controls. |
| `RULEBRICKS_CREATE_CONTEXT_RELATIONSHIP` | Create Context Relationship | Create a has-many, has-one, or belongs-to relationship from one Rulebricks context to another. |
| `RULEBRICKS_CREATE_FOLDER` | Create Folder | Create a folder for rule, flow, or context assets; the asset type defaults to rule. |
| `RULEBRICKS_CREATE_USER` | Create User | Create a new user directly with a password, bypassing the email invitation flow. The user can immediately log in with the provided credentials. The provider-issued API key is omitted from the response. |
| `RULEBRICKS_CREATE_USER_GROUP` | Create User Group | Create a new user group in your Rulebricks organization. |
| `RULEBRICKS_DELETE_ASSET_TEST` | Delete Asset Test | Permanently delete one saved test case from a Rulebricks rule or flow. |
| `RULEBRICKS_DELETE_CONTEXT` | Delete Context | Delete a Rulebricks context and all of its live instances, returning affected bindings and pending evaluations. |
| `RULEBRICKS_DELETE_CONTEXT_INSTANCE` | Delete Context Instance | Permanently delete one Rulebricks context instance and its history, cancel its pending evaluations, and re-evaluate dependent context instances. Ready dependent rules or flows may execute; flows may invoke external actions. |
| `RULEBRICKS_DELETE_CONTEXT_RELATIONSHIP` | Delete Context Relationship | Delete a specific relationship owned by a Rulebricks context. |
| `RULEBRICKS_DELETE_FLOW` | Delete Flow | Permanently delete one Rulebricks flow by ID. |
| `RULEBRICKS_DELETE_FOLDER` | Delete Folder | Delete one folder by ID without deleting the assets it contains. |
| `RULEBRICKS_DELETE_OBJECT` | Delete Object | Delete a workspace object by ID or exact name and archive, delete, or detach its generated values. |
| `RULEBRICKS_DELETE_RULE` | Delete Rule | Permanently delete one Rulebricks rule by ID. |
| `RULEBRICKS_DELETE_VALUE` | Delete Value | Delete one vocabulary value by ID and replace references from other values with its content; rule or flow references and object-managed namespaces can block deletion. |
| `RULEBRICKS_EXECUTE_ASSETS_IN_PARALLEL` | Execute Assets in Parallel | Execute multiple published Rulebricks rules or flows in parallel from one named map. Each entry is independent, so successful results are returned alongside reserved `$error` details for entries that fail. Flows may invoke external actions, and retrying an uncertain request can repeat their effects. A successful call uses the organization's monthly execution allowance for each entry. |
| `RULEBRICKS_EXECUTE_BULK_RULE` | Execute Bulk Rule | Execute one published Rulebricks rule against up to 1000 ordered input objects and return one aligned result per input. A successful call uses the organization's monthly execution allowance for each input. |
| `RULEBRICKS_EXECUTE_FLOW` | Execute Flow | Execute a published Rulebricks flow once or in bulk and return the ordered flow-defined output and execution ID for querying its decision logs. A flow may invoke external actions, and retrying an uncertain request can repeat their effects. A successful execution uses the organization's monthly execution allowance. |
| `RULEBRICKS_EXECUTE_RULE` | Execute Rule | Execute a published Rulebricks rule with its input payload and return the rule-defined decision output. A successful execution uses the organization's monthly execution allowance. |
| `RULEBRICKS_EXPORT_FLOW` | Export Flow | Export one flow as a Rulebricks Flow Schema document that can be round-tripped through the flow import endpoint. Provide flow_id or flow_slug; at least one is required, and the provider accepts both together. |
| `RULEBRICKS_EXPORT_MANIFEST` | Export Asset Manifest | Export selected Rulebricks rules, flows, contexts, or values with their resolved dependencies, or preview the export. Provide at least one of root_ids, root_collection, root_collections, or all_values=true for value catalogs; selectors may be combined. |
| `RULEBRICKS_EXPORT_RULE` | Export Rule | Export one rule by ID as a raw rule document that can be round-tripped through the Rulebricks rule import endpoint. |
| `RULEBRICKS_GET_CONTEXT` | Get Context | Retrieve a Rulebricks context by ID, including its schema, bindings, access controls, and relationships. |
| `RULEBRICKS_GET_CONTEXT_INSTANCE` | Get Context Instance | Retrieve the current base facts, derived facts, status, and selected execution or relationship data for one Rulebricks context instance. |
| `RULEBRICKS_GET_CONTEXT_INSTANCE_HISTORY` | Get Context Instance History | Retrieve newest-first historical values for all fields or one selected field on a Rulebricks context instance. |
| `RULEBRICKS_GET_OBJECT` | Get Object | Fetch one workspace object (JSON Schema) by its ID or exact name. |
| `RULEBRICKS_GET_USAGE` | Get Usage | Return the organization's current plan and monthly Rulebricks execution usage, limit, and remaining allowance. |
| `RULEBRICKS_IMPORT_FLOW` | Import Flow | Create or update a flow from a Rulebricks Flow Schema document; imported flows publish by default unless publish (provider field _publish) is false. |
| `RULEBRICKS_IMPORT_MANIFEST` | Import Asset Manifest | Atomically create or update rules, flows, contexts, and values from a Rulebricks manifest. Override updates conflicts in place while preserving prior versions, release pins, context records, IDs, folders, and access groups. Use PREVIEW_IMPORT_MANIFEST to inspect the write-free plan first. |
| `RULEBRICKS_IMPORT_RULE` | Import Rule | Create a rule from a complete raw rule document, or partially update an existing rule when the document includes its ID. |
| `RULEBRICKS_INVITE_USER` | Invite User | Invite a new user to the organization or update role or user group data for an existing user. |
| `RULEBRICKS_LIST_ASSET_TESTS` | List Asset Tests | List saved test cases for a Rulebricks rule or flow, including expected responses and latest execution state. |
| `RULEBRICKS_LIST_CONTEXT_RELATIONSHIPS` | List Context Relationships | List incoming and outgoing relationships configured for a Rulebricks context. |
| `RULEBRICKS_LIST_CONTEXTS` | List Contexts | List contexts visible to the connected API key, optionally filtered or paginated by the provider's opaque cursor. |
| `RULEBRICKS_LIST_FLOWS` | List Flows | List flows visible to the connected API key, optionally selecting an exact asset version or filtering by identifier, search, folder, labels, group, or name. |
| `RULEBRICKS_LIST_FOLDERS` | List Folders | List asset folders visible to the connected API key, optionally filtered by user group or name. |
| `RULEBRICKS_LIST_OBJECTS` | List Objects | List workspace objects (JSON Schemas) visible to the connected API key's user groups. |
| `RULEBRICKS_LIST_PENDING_CONTEXT_EVALUATIONS` | List Pending Context Evaluations | List rule and flow evaluations registered as pending for one Rulebricks context instance, including their missing dependencies. |
| `RULEBRICKS_LIST_RULES` | List Rules | List rules visible to the connected API key, optionally selecting an exact asset version or filtering by identifier, search, folder, labels, group, or name. |
| `RULEBRICKS_LIST_USER_GROUPS` | List User Groups | List all user groups available in your Rulebricks organization. |
| `RULEBRICKS_LIST_USERS` | List Users | List all users (including the admin and all team members) in the organization with their email, name, role, user groups, and join date. Provider-issued API keys are omitted from the response. |
| `RULEBRICKS_LIST_VALUES` | List Values | Return one page of vocabulary values visible to the connected API key, with optional name, prefix, type, group, and usage filters. |
| `RULEBRICKS_PREVIEW_IMPORT_MANIFEST` | Preview Asset Manifest Import | Return the server-authoritative plan for importing Rulebricks rules, flows, contexts, and values without writing any assets. |
| `RULEBRICKS_PREVIEW_SYNC_VALUES` | Preview Value Collection Sync | Preview the created, updated, unchanged, archived, and deleted values for one complete single-request collection synchronization without writing changes. |
| `RULEBRICKS_PREVIEW_UPSERT_OBJECT` | Preview Object Upsert | Validate and preview creating or updating a workspace object and synchronizing its JSON Schema enum values without writing any changes. |
| `RULEBRICKS_QUERY_DECISION_LOGS` | Query Decision Logs | Return one page of decision logs filtered by assets, status, trace, payload content, or time range. Check limited even when no next cursor is returned; a limited page does not cover all matching history. |
| `RULEBRICKS_REPLACE_VALUE_METADATA` | Replace Value Metadata | Replace or clear all custom metadata for one vocabulary value by ID without resending its value payload. The API key must have edit-values permission. |
| `RULEBRICKS_RUN_ASSET_TESTS` | Run Asset Tests | Run all saved tests, or only critical tests, against the latest draft of a Rulebricks rule or flow and return pass totals and failure diagnostics. Version targeting is not supported. |
| `RULEBRICKS_SOLVE_CONTEXT_ASSET` | Solve Context Asset | Persist optional facts and execute one rule or flow bound to a Rulebricks context instance, or register it pending when dependencies are missing. Flows may cause external effects; retrying an uncertain outcome can repeat them. |
| `RULEBRICKS_SUBMIT_CONTEXT_DATA` | Submit Context Data | Merge facts into one Rulebricks context instance. This may immediately execute bound rules or flows and cause their external effects; returns the resolved state and triggered evaluations. |
| `RULEBRICKS_SYNC_VALUES` | Sync Value Collection | Synchronize one vocabulary collection to a desired set. Chunks commit independently and must run sequentially under one fresh sync_id; finalize only after every chunk succeeds and do not overlap collection pipelines. Completion archives or deletes omitted members. This action always writes. |
| `RULEBRICKS_UPDATE_CONTEXT` | Update Context | Update a Rulebricks context's name, schema, identity, retention, execution behavior, folder, or access groups. Changing identity_fact on a context with live instances changes how future writes resolve them. |
| `RULEBRICKS_UPDATE_FOLDER` | Update Folder | Update an existing folder's required name and optional description by ID without changing its asset type. |
| `RULEBRICKS_UPLOAD_MANIFEST_PART` | Upload Manifest Part | Upload one plain UTF-8 or gzip-compressed part of a Rulebricks manifest larger than 4 MiB. Reuse one upload_id, send parts in zero-based order, then pass that ID and the total part count as manifest_upload to IMPORT_MANIFEST. Parts expire after 24 hours. |
| `RULEBRICKS_UPSERT_OBJECT` | Upsert Object | Create a workspace object by name or update one by ID or name, then synchronize values generated from its JSON Schema enums. Generated values removed from the submitted schema are archived. This action always writes. |
| `RULEBRICKS_UPSERT_VALUES` | Create or Update Values | Create new vocabulary values or update existing values by name, including nested values and per-value metadata. |

## Supported Triggers

None listed.

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

Once connected, ChatGPT can access the Rulebricks MCP server via Composio to run actions that you authorize, directly in your workspace.

## Complete Code

None listed.

## How to build Rulebricks MCP Agent with another framework

- [Claude Cowork](https://composio.dev/toolkits/rulebricks/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/rulebricks/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/rulebricks/framework/atomic-agent)

## Related Toolkits

- [0CodeKit](https://composio.dev/toolkits/0codekit) - 0CodeKit is a utility API platform for AI, document, image, and data workflows. Use it to convert, validate, generate, store, and automate data without custom backend code.
- [Airtop](https://composio.dev/toolkits/airtop) - Airtop is a cloud browser platform for AI-powered web automation. Use it to navigate sites, extract data, and run reusable browser workflows.
- [Apify MCP](https://composio.dev/toolkits/apify_mcp) - Apify MCP is the official MCP server for Apify's web scraping and browser automation platform. Use it to run actors, collect structured web data, and automate crawling workflows.
- [Apilio](https://composio.dev/toolkits/apilio) - Apilio is a home automation platform that lets you connect and control smart devices from different brands. It helps you build flexible automations with complex conditions, schedules, and integrations.
- [Basin](https://composio.dev/toolkits/basin) - Basin is a no-code form backend for quickly setting up reliable contact forms. It lets you collect and manage form submissions without writing any server-side code.
- [Bika.ai](https://composio.dev/toolkits/bika) - Bika.ai is an AI automation database platform for managing spaces, teams, records, automations, and outgoing webhooks. It helps teams organize structured data and automate database-driven workflows in one place.
- [Botster](https://composio.dev/toolkits/botster) - Botster is a web automation service for running configurable data collection bots. Use it to collect structured web data without building and maintaining scrapers yourself.
- [Bouncer](https://composio.dev/toolkits/bouncer) - Bouncer is an email validation platform that verifies the authenticity of email addresses in real-time and batch. It helps boost deliverability and reduce bounce rates for your communications.
- [BrowserAct](https://composio.dev/toolkits/browseract) - BrowserAct is a hosted browser-automation service for running web workflows. Use it to execute repeatable browser tasks with templates, proxies, and APIs.
- [Celigo](https://composio.dev/toolkits/celigo) - Celigo is an integration platform as a service for connecting apps, data, and business workflows. It helps teams automate cross-system processes without building every integration from scratch.
- [CheckFlow](https://composio.dev/toolkits/checkflow) - CheckFlow is a workflow and checklist platform for repeatable processes, tasks, templates, teams, data sets, and automation. Use it to standardize operations, track process execution, and keep teams aligned.
- [Conveyor](https://composio.dev/toolkits/conveyor) - Conveyor is a platform that automates security reviews with a Trust Center and AI-driven questionnaire automation. It streamlines compliance and vendor security processes for faster, hassle-free reviews.
- [CrewAI](https://composio.dev/toolkits/crew_ai) - CrewAI is a platform for running deployed automations and managing AMP control-plane resources. Use it to automate workflows and centrally control SaaS automation resources.
- [Cronfree Time Scheduler](https://composio.dev/toolkits/cronfree_time_scheduler) - Cronfree Time Scheduler is an API-based scheduler for recurring webhook calls. Use it to create and remove timezone-aware schedules without running cron.
- [Crowdin](https://composio.dev/toolkits/crowdin) - Crowdin is a localization management platform that streamlines translation workflows and collaboration. It helps teams centralize multilingual content, boost productivity, and automate translation processes.
- [Databox](https://composio.dev/toolkits/databox) - Databox is a business analytics platform that connects your data from any tool and device. It helps you track KPIs, build dashboards, and discover actionable insights.
- [Detrack](https://composio.dev/toolkits/detrack) - Detrack is a delivery management platform for real-time tracking and proof of delivery. It helps businesses automate notifications and keep customers updated every step of the way.
- [Dify](https://composio.dev/toolkits/dify) - Dify is a platform for running and managing published workflow apps via a Service API. Use it to execute workflows and inspect configuration and run history quickly.
- [Digital Humani](https://composio.dev/toolkits/digital_humani) - Digital Humani is a reforestation API for browsing planting projects, submitting tree requests, and tracking planted trees. It helps teams connect climate action directly to products, campaigns, and customer experiences.
- [Dnsfilter](https://composio.dev/toolkits/dnsfilter) - Dnsfilter is a cloud-based DNS security and content filtering solution. It helps organizations block online threats and manage safe internet access with ease.

## Frequently Asked Questions

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

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

### Can I use Tool Router MCP with ChatGPT?

Yes, you can. ChatGPT 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 Rulebricks tools.

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

Yes, absolutely. You can configure which Rulebricks 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 Rulebricks data and credentials are handled as safely as possible.

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