# Griptape — how to use (mcp.ai)

Connect your Griptape account and use 143 tools for artificial intelligence straight from your AI agent. Connect with your own API key. Griptape is a comprehensive platform offering tools and frameworks for building, deploying, and scaling generative AI applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_griptape?ms=1787293380000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `griptape_assistant_creation`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/griptape`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/griptape/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/griptape/assistant/creation` — Tool to create a new assistant. Use when you need to register a uniquely named assistant in Griptape Cloud before initiating runs.
  - body: { name: string, input?: string, model?: string, tool_ids?: string[], description?: string, ruleset_ids?: string[], retriever_ids?: string[], structure_ids?: string[], knowledge_base_ids?: string[] }
- `POST https://api.mcp.ai/api/griptape/assistant/listing` — Tool to list all assistants. Use after authenticating with Griptape Cloud to retrieve available assistants. Supports optional pagination.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/griptape/assistant/run/cancellation` — Tool to cancel an ongoing assistant run. Use when you need to stop a run prematurely after confirming the run ID is valid.
  - body: { assistant_run_id: string }
- `POST https://api.mcp.ai/api/griptape/assistant/run/creation` — Creates a new assistant run to execute a conversation turn with a Griptape Cloud assistant. Use this action to send input messages to an assistant and initiate processing. The run is queued and proces
  - body: { args?: string[], input?: string, stream?: boolean, tool_ids?: string[], thread_id?: string, ruleset_ids?: string[], assistant_id: string, structure_ids?: string[], knowledge_base_ids?: string[], additional_tool_ids?: string[], additional_ruleset_ids?: string[], additional_structure_ids?: string[], additional_knowledge_base_ids?: string[] }
- `POST https://api.mcp.ai/api/griptape/assistant/run/error/details` — Tool to fetch detailed error information for a specific assistant run. Use after an assistant run has failed to inspect error details.
  - body: { run_id: string }
- `POST https://api.mcp.ai/api/griptape/assistant/run/listing` — Tool to list all runs for a given assistant. Use when you need historical run executions for analysis after using the assistant.
  - body: { limit?: integer, offset?: integer, assistant_id: string }
- `POST https://api.mcp.ai/api/griptape/assistant/run/logs/retrieval` — Retrieve the complete execution logs for an assistant run in Griptape Cloud. Returns a chronological timeline of events that occurred during the run, including: - Structure lifecycle events (start/fin
  - body: { assistant_run_id: string }
- `POST https://api.mcp.ai/api/griptape/assistant/run/retrieval` — Tool to retrieve an assistant run's status and details. Use when you need current status and metadata for a specific assistant run.
  - body: { assistant_run_id: string }
- `POST https://api.mcp.ai/api/griptape/assistant/run/retry` — Tool to attempt retrying a failed assistant run. If retry is not available (e.g., run hasn't failed or endpoint not supported), returns the current run status instead. Use when checking if a run can b
  - body: { run_id: string }
- `POST https://api.mcp.ai/api/griptape/cancel/data/job` — Tool to cancel a running or queued data job. Use when you need to stop a data job that is in progress or queued.
  - body: { data_job_id: string }
- `POST https://api.mcp.ai/api/griptape/create/bucket` — Tool to create a new bucket in Griptape Cloud. Use when you need to create storage buckets for organizing assets and data.
  - body: { name: string }
- `POST https://api.mcp.ai/api/griptape/create/bucket/asset` — Tool to create a new asset in a Griptape Cloud bucket. Use when you need to add a new asset to a bucket by specifying its name.
  - body: { name: string, bucket_id: string }
- `POST https://api.mcp.ai/api/griptape/create/data/connector` — Tool to create a new data connector in Griptape Cloud. Data connectors enable ingestion from various sources like web pages, Confluence, Google Drive, S3, or data lakes. After creation, the connector 
  - body: { name: string, type: string, config: object, transforms?: object[], description?: string, schedule_expression?: string }
- `POST https://api.mcp.ai/api/griptape/create/data/connector/job` — Tool to create a data job for a data connector in Griptape Cloud. Use when you need to trigger data ingestion or processing for a specific data connector. The job will be queued and executed asynchron
  - body: { data_connector_id: string }
- `POST https://api.mcp.ai/api/griptape/create/export/job` — Tool to create a new export job in Griptape Cloud. Use when you need to initiate an export operation with custom data.
  - body: { metadata?: object, export_data: object }
- `POST https://api.mcp.ai/api/griptape/create/function` — Tool to create a new function in Griptape Cloud. Use when you need to register a new serverless function with optional code configuration and environment variables.
  - body: { code?: object, name: string, env_vars?: object[], description?: string, function_config_file?: string }
- `POST https://api.mcp.ai/api/griptape/create/function/deployment` — Tool to create a new deployment for a function from a code source. Use when you need to deploy a function from a GitHub repository to Griptape Cloud.
  - body: { force?: boolean, code_source: object, function_id: string }
- `POST https://api.mcp.ai/api/griptape/create/import/job` — Tool to create a new import job in Griptape Cloud. Use when you need to initiate a data import operation from a data lake asset (e.g., S3 bucket) into Griptape Cloud.
  - body: { metadata?: object, import_type: string, resource_suffix?: string, data_lake_asset_path: string }
- `POST https://api.mcp.ai/api/griptape/create/integration` — Tool to create a new integration in Griptape Cloud. Use when you need to register a new integration (slack, github_app, or webhook) to connect external services with assistants or structures.
  - body: { name: string, type: string, config: object, description?: string, assistant_ids?: string[], structure_ids?: string[] }
- `POST https://api.mcp.ai/api/griptape/create/knowledge/base` — Tool to create a new knowledge base in Griptape Cloud. Use when you need to set up a vector store for document indexing and semantic search.
  - body: { name: string, type: string, config: object, transforms?: object[], asset_paths?: string[], description?: string, embedding_model?: string, use_default_embedding_model?: boolean }
- `POST https://api.mcp.ai/api/griptape/create/knowledge/base/job` — Tool to create a knowledge base job for ingesting data into a knowledge base. Use when you need to trigger data ingestion or processing for a specific knowledge base.
  - body: { knowledge_base_id: string }
- `POST https://api.mcp.ai/api/griptape/create/library` — Tool to create a new library in Griptape Cloud. Use when you need to organize data connectors and knowledge bases for an assistant to use.
  - body: { name: string, description?: string, data_connector_ids: string[], knowledge_base_configs: object[] }
- `POST https://api.mcp.ai/api/griptape/create/model` — Tool to create a new model configuration in Griptape Cloud. Use when you need to register a new model with specific authentication and configuration settings before using it in assistants or other Gri
  - body: { active?: boolean, kwargs?: object, model_name: string, model_type: string, description?: string, auth_config_id: string }
- `POST https://api.mcp.ai/api/griptape/create/model/auth/config` — Tool to create a model authentication configuration in Griptape Cloud. Use when you need to set up new authentication for a model API endpoint.
  - body: { name: string, base_url: string, api_key_secret_id: string }
- `POST https://api.mcp.ai/api/griptape/create/organization/api/key` — Tool to create a new API key for a specific organization. Use when you need to generate a new API key for authentication purposes. The API key value is only returned once during creation.
  - body: { name: string, organization_id: string }
- `POST https://api.mcp.ai/api/griptape/create/retriever` — Tool to create a new retriever in Griptape Cloud. Use when you need to create a retriever with associated components for document retrieval capabilities.
  - body: { name: string, description?: string, retriever_components?: object[], retriever_component_ids?: string[] }
- `POST https://api.mcp.ai/api/griptape/create/rule` — Tool to create a new rule in Griptape Cloud. Use when you need to define behavioral guidelines or constraints for AI assistants.
  - body: { name: string, rule: string, metadata?: object }
- `POST https://api.mcp.ai/api/griptape/create/secret` — Tool to create a new secret in Griptape Cloud. Use when you need to store sensitive information like API keys, passwords, or tokens.
  - body: { name: string, value: string }
- `POST https://api.mcp.ai/api/griptape/create/structure` — Tool to create a new structure in Griptape Cloud. Use when you need to register a workflow or data processing pipeline that can be deployed and executed.
  - body: { code?: object, name: string, env_vars?: object[], description?: string, webhook_enabled?: boolean, structure_config_file?: string }
- `POST https://api.mcp.ai/api/griptape/create/structure/deployment` — Tool to create a new deployment for a structure. Use when you need to deploy a structure from a GitHub repository to Griptape Cloud.
  - body: { force?: boolean, code_source: object, structure_id: string }
- `POST https://api.mcp.ai/api/griptape/create/thread` — Tool to create a new thread in Griptape Cloud. Use when you need to start a new conversation thread for organizing messages and interactions.
  - body: { name: string, alias?: string, messages?: object[], metadata?: object }
- `POST https://api.mcp.ai/api/griptape/create/thread/message` — Tool to create a new message in a specific thread. Use when you need to add a message with input and output content to a conversation thread in Griptape Cloud.
  - body: { input: string, output: string, metadata?: object, thread_id: string }
- `POST https://api.mcp.ai/api/griptape/create/tool/deployment` — Create a new deployment for a tool from a GitHub repository. Use when you need to deploy or update tool code from a GitHub source. The deployment process is asynchronous - use the Get Tool Deployment 
  - body: { force?: boolean, tool_id: string, code_source: object }
- `POST https://api.mcp.ai/api/griptape/delete/api/key` — Tool to delete an API key by ID. Use when you need to permanently remove an API key from Griptape Cloud.
  - body: { api_key_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/assistant` — Tool to delete an assistant by ID. Use when you need to permanently remove an assistant from Griptape Cloud.
  - body: { assistant_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/bucket` — Tool to delete a bucket by ID. Use when you need to remove a specific bucket from Griptape Cloud.
  - body: { bucket_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/bucket/asset` — Tool to delete a specific asset from a Griptape Cloud bucket. Use when you need to remove an asset from a bucket by name.
  - body: { name: string, bucket_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/data/connector` — Tool to delete a data connector. Use when you need to permanently remove a data connector from Griptape Cloud.
  - body: { data_connector_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/function` — Tool to delete a function from Griptape Cloud. Use when you need to permanently remove a function by its ID.
  - body: { function_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/integration` — Tool to delete an integration by ID. Use when you need to permanently remove an integration from Griptape Cloud.
  - body: { integration_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/knowledge/base` — Tool to delete a Knowledge Base from Griptape Cloud. Use when you need to permanently remove a knowledge base and all its associated data. This operation cannot be undone.
  - body: { knowledge_base_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/library` — Tool to delete a library from Griptape Cloud. Use when you need to permanently remove a library resource.
  - body: { library_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/message` — Tool to delete a message by its ID. Use when you need to remove a specific message from Griptape Cloud.
  - body: { message_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/model` — Tool to delete a model configuration from Griptape Cloud. Use when you need to permanently remove a model configuration.
  - body: { model_config_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/model/auth/config` — Tool to delete a model auth config by ID. Use when you need to permanently remove a model authentication configuration from Griptape Cloud.
  - body: { auth_config_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/rule` — Tool to delete a rule by its ID. Use when you need to permanently remove a rule from Griptape Cloud.
  - body: { rule_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/ruleset` — Tool to permanently delete a ruleset from Griptape Cloud by its ID. Use when you need to remove a ruleset and all its associated rules. This operation cannot be undone.
  - body: { ruleset_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/secret` — Tool to delete a secret from Griptape Cloud. Use when you need to permanently remove a secret by its ID.
  - body: { secret_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/structure` — Tool to delete a structure from Griptape Cloud. Use when you need to permanently remove a structure by its ID. This operation is irreversible.
  - body: { structure_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/thread` — Tool to delete a thread by its ID. Use when you need to permanently remove a conversation thread and all its associated messages from Griptape Cloud.
  - body: { thread_id: string }
- `POST https://api.mcp.ai/api/griptape/delete/tool` — Tool to delete a tool from Griptape Cloud. Use when you need to permanently remove a tool resource by its ID.
  - body: { tool_id: string }
- `POST https://api.mcp.ai/api/griptape/get/api/key` — Tool to retrieve an API key's details. Use when you need to get information about a specific API key by its ID.
  - body: { api_key_id: string }
- `POST https://api.mcp.ai/api/griptape/get/assistant` — Tool to retrieve a specific assistant's details by ID. Use when you need detailed information about a particular assistant including its configuration, knowledge bases, and tools.
  - body: { assistant_id: string }
- `POST https://api.mcp.ai/api/griptape/get/billing/management/url` — Tool to retrieve the billing management portal URL. Use when you need to access or redirect users to the billing portal for subscription or payment management.
- `POST https://api.mcp.ai/api/griptape/get/bucket` — Tool to retrieve a bucket's details by its ID. Use when you need to fetch information about a specific bucket in Griptape Cloud.
  - body: { bucket_id: string }
- `POST https://api.mcp.ai/api/griptape/get/bucket/asset` — Tool to retrieve a specific asset from a Griptape Cloud bucket. Use when you need to fetch asset metadata or contents from a bucket by name.
  - body: { name: string, bucket_id: string, include_contents?: boolean }
- `POST https://api.mcp.ai/api/griptape/get/bucket/asset/url` — Tool to generate a signed URL for accessing or uploading bucket assets. Use when you need a temporary URL to GET (download) or PUT (upload) an asset in a Griptape Cloud bucket.
  - body: { name: string, bucket_id: string, operation?: string }
- `POST https://api.mcp.ai/api/griptape/get/config` — Tool to retrieve Griptape Cloud configuration. Use when you need to access data lake settings or Google Drive connector configuration.
- `POST https://api.mcp.ai/api/griptape/get/credits/balance` — Tool to retrieve the current credits balance. Use when you need to check available credits for billing or usage tracking.
- `POST https://api.mcp.ai/api/griptape/get/data/connector` — Tool to retrieve a data connector's configuration and details from Griptape Cloud. Use when you need information about a specific data connector including its type, configuration, and metadata.
  - body: { data_connector_id: string }
- `POST https://api.mcp.ai/api/griptape/get/data/job` — Tool to retrieve a data job's status and details by its ID. Use when you need to check the current status, ingestion progress, or errors for a specific data job.
  - body: { data_job_id: string }
- `POST https://api.mcp.ai/api/griptape/get/export/job` — Tool to retrieve an export job by ID. Use when you need to check the status or details of an export operation.
  - body: { export_job_id: string }
- `POST https://api.mcp.ai/api/griptape/get/function` — Tool to retrieve a function's details. Use when you need to get configuration, environment variables, or metadata for a specific function in Griptape Cloud.
  - body: { function_id: string }
- `POST https://api.mcp.ai/api/griptape/get/import/job` — Tool to retrieve an import job's status and details. Use when you need to check the current status and metadata for a specific import job.
  - body: { import_job_id: string }
- `POST https://api.mcp.ai/api/griptape/get/integration` — Tool to retrieve a specific integration's details by ID. Use when you need detailed information about a particular integration including its configuration, associated assistants, and structures.
  - body: { integration_id: string }
- `POST https://api.mcp.ai/api/griptape/get/knowledge/base` — Tool to retrieve a knowledge base's configuration and details from Griptape Cloud. Use when you need information about a specific knowledge base including its type, configuration, embedding model, and
  - body: { knowledge_base_id: string }
- `POST https://api.mcp.ai/api/griptape/get/knowledge/base/job` — Tool to retrieve a knowledge base job's status and details by its ID. Use when you need to check the current status, ingestion progress, or errors for a specific knowledge base job.
  - body: { knowledge_base_job_id: string }
- `POST https://api.mcp.ai/api/griptape/get/knowledge/base/search` — Tool to retrieve details of a specific knowledge base search by its ID. Use when you need to fetch results of a previously executed knowledge base search.
  - body: { knowledge_base_search_id: string }
- `POST https://api.mcp.ai/api/griptape/get/library` — Tool to retrieve a specific library's details by ID. Use when you need detailed information about a library including its associated assistant, retrievers, knowledge bases, and data connectors.
  - body: { library_id: string }
- `POST https://api.mcp.ai/api/griptape/get/message` — Tool to retrieve a specific message's details by ID. Use when you need detailed information about a particular message from a thread.
  - body: { message_id: string }
- `POST https://api.mcp.ai/api/griptape/get/model` — Tool to retrieve a model configuration's details by its ID. Use when you need to get information about a specific model configuration in Griptape Cloud, including its name, type, authentication settin
  - body: { model_config_id: string }
- `POST https://api.mcp.ai/api/griptape/get/model/auth/config` — Tool to retrieve a model auth config by ID. Use when you need to get configuration details for model authentication in Griptape Cloud.
  - body: { auth_config_id: string }
- `POST https://api.mcp.ai/api/griptape/get/organization` — Tool to retrieve an organization's details by its ID. Use when you need information about a specific organization including its configuration, entitlement, and metadata.
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/griptape/get/retriever` — Tool to retrieve a retriever's details by its ID. Use when you need to fetch information about a specific retriever in Griptape Cloud, including its components and configuration.
  - body: { retriever_id: string }
- `POST https://api.mcp.ai/api/griptape/get/retriever/component` — Tool to retrieve a retriever component's details by its ID. Use when you need to fetch information about a specific retriever component in Griptape Cloud.
  - body: { retriever_component_id: string }
- `POST https://api.mcp.ai/api/griptape/get/rule` — Tool to retrieve a specific rule's details by ID. Use when you need detailed information about a particular rule including its content, metadata, and timestamps.
  - body: { rule_id: string }
- `POST https://api.mcp.ai/api/griptape/get/ruleset` — Tool to retrieve a specific ruleset's details by ID. Use when you need detailed information about a particular ruleset including its name, rules, metadata, and timestamps.
  - body: { ruleset_id: string }
- `POST https://api.mcp.ai/api/griptape/get/ruleset/by/alias` — Retrieve a ruleset from Griptape Cloud by its unique alias identifier. The alias is typically an auto-generated 32-character hash (e.g., 'e9990de9925a40d1b8fce8455c63651f') created when the ruleset wa
  - body: { alias: string }
- `POST https://api.mcp.ai/api/griptape/get/secret` — Tool to retrieve a secret's details from Griptape Cloud. Use when you need information about a specific secret including its name, organization, and usage timestamps.
  - body: { secret_id: string }
- `POST https://api.mcp.ai/api/griptape/get/structure` — Tool to retrieve a structure's configuration and details from Griptape Cloud. Use when you need detailed information about a specific structure including its deployment, environment variables, and cod
  - body: { structure_id: string }
- `POST https://api.mcp.ai/api/griptape/get/structures/dashboard` — Tool to retrieve dashboard metrics for structures. Use when you need analytics on deployments, runs, errors, durations, and token usage.
  - body: { period?: string, end_time?: string, start_time?: string, structure_ids?: string }
- `POST https://api.mcp.ai/api/griptape/get/thread` — Tool to retrieve a specific thread's details by ID. Use when you need detailed information about a particular conversation thread including its metadata and message statistics.
  - body: { thread_id: string }
- `POST https://api.mcp.ai/api/griptape/get/tool` — Tool to retrieve a specific tool's details by ID. Use when you need detailed information about a particular tool including its configuration, environment variables, and deployment status.
  - body: { tool_id: string }
- `POST https://api.mcp.ai/api/griptape/get/usage` — Tool to retrieve current usage statistics. Use when you need to check bytes ingested, RAG queries, runtime seconds, and their respective limits for the billing period.
- `POST https://api.mcp.ai/api/griptape/get/user` — Tool to retrieve a user's details by their ID. Use when you need information about a specific user including their email, name, and organization memberships.
  - body: { user_id: string }
- `POST https://api.mcp.ai/api/griptape/list/assistant/run/events` — Tool to list events for an assistant run with pagination support. Use when you need to retrieve execution events in a paginated manner, as opposed to streaming them.
  - body: { limit?: integer, offset?: integer, assistant_run_id: string }
- `POST https://api.mcp.ai/api/griptape/list/bucket/assets` — Tool to list assets in a bucket. Use when you need to retrieve files stored in a Griptape Cloud bucket. Supports pagination and filtering by name prefix/postfix.
  - body: { page?: integer, prefix?: string, postfix?: string, bucket_id: string, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/buckets` — Tool to list all buckets in Griptape Cloud. Use after authenticating to retrieve available buckets with pagination support.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/connections` — Tool to list all connections. Use after authenticating with Griptape Cloud to retrieve available connections. Supports optional pagination and type filtering.
  - body: { page?: integer, type?: string, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/data/connectors` — Tool to list all data connectors. Use when you need to discover available data connectors and their configurations in Griptape Cloud. Supports pagination.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/embedding/drivers` — Tool to list available embedding drivers. Use when you need to retrieve supported drivers and their models before embedding text.
  - body: { endpoint_override?: string }
- `POST https://api.mcp.ai/api/griptape/list/export/jobs` — Tool to list export jobs from Griptape Cloud. Use when you need to view all export jobs with optional filtering by status and pagination.
  - body: { page?: integer, status?: string[], page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/function/deployments` — Tool to list all deployments for a specific function. Use when you need to retrieve deployment history and status for a function in Griptape Cloud.
  - body: { page?: integer, page_size?: integer, function_id: string }
- `POST https://api.mcp.ai/api/griptape/list/functions` — Tool to list all functions with optional pagination. Use when you need to discover available functions and their IDs in Griptape Cloud.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/import/jobs` — Tool to list import jobs in Griptape Cloud. Use when you need to retrieve import jobs with optional filtering by status and pagination support.
  - body: { page?: integer, status?: string[], page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/integrations` — Tool to list all integrations. Use when you need to discover available integrations in Griptape Cloud. Supports optional pagination.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/knowledge/base/jobs` — Tool to list knowledge base jobs for a specific knowledge base. Use when you need to retrieve jobs with optional filtering by status and pagination support.
  - body: { page?: integer, status?: string[], page_size?: integer, knowledge_base_id: string }
- `POST https://api.mcp.ai/api/griptape/list/knowledge/base/queries` — Tool to list all queries made to a specific Griptape Cloud knowledge base. Use when you need to retrieve historical query records including query text, results, and metadata. Supports pagination for l
  - body: { page?: integer, page_size?: integer, knowledge_base_id: string }
- `POST https://api.mcp.ai/api/griptape/list/knowledge/base/searches` — Tool to list all searches performed on a specific knowledge base. Use when you need to view the search history for a knowledge base.
  - body: { page?: integer, page_size?: integer, knowledge_base_id: string }
- `POST https://api.mcp.ai/api/griptape/list/knowledge/bases` — Tool to list all knowledge bases. Use to retrieve available knowledge bases in Griptape Cloud with optional pagination.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/libraries` — Tool to list all libraries in Griptape Cloud. Use after authenticating to retrieve available libraries with pagination support.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/model/auth/configs` — Tool to list all model authentication configurations with optional pagination. Use when you need to discover available model auth configs and their IDs in Griptape Cloud.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/models` — Tool to list all models in Griptape Cloud. Use when you need to discover available models and their configurations. Supports pagination and filtering by model type or default status.
  - body: { page?: integer, default?: boolean, page_size?: integer, model_type?: string }
- `POST https://api.mcp.ai/api/griptape/list/organization/api/keys` — Tool to list all API keys in a specific organization. Use when you need to retrieve all API keys for an organization with optional pagination support.
  - body: { page?: integer, page_size?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/griptape/list/organizations` — Tool to list all organizations in Griptape Cloud. Use after authenticating to retrieve available organizations.
- `POST https://api.mcp.ai/api/griptape/list/retriever/components` — Tool to list all retriever components in Griptape Cloud. Use when you need to discover available retriever components and their configurations. Supports pagination.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/retrievers` — Tool to list all retrievers in Griptape Cloud. Use to retrieve available retrievers with optional pagination support.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/rules` — Tool to list all rules in Griptape Cloud with optional pagination and filtering. Use when you need to retrieve available rules and their details.
  - body: { page?: integer, page_size?: integer, ruleset_id?: string }
- `POST https://api.mcp.ai/api/griptape/list/secrets` — Tool to list all secrets in Griptape Cloud. Use to retrieve available secrets with optional pagination.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/structure/deployments` — Tool to list all deployments for a specific structure. Use when you need to retrieve deployment history and status for a structure in Griptape Cloud.
  - body: { page?: integer, status?: string[], page_size?: integer, structure_id: string }
- `POST https://api.mcp.ai/api/griptape/list/structure/runs` — Tool to list all runs for a specific structure with optional pagination and status filtering. Use when you need to retrieve historical execution runs for a structure.
  - body: { page?: integer, status?: string[], page_size?: integer, structure_id: string }
- `POST https://api.mcp.ai/api/griptape/list/structures` — Tool to list all structures in Griptape Cloud. Use to retrieve available structures with optional pagination support.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/thread/messages` — Tool to list all messages in a specific thread. Use when you need to retrieve the conversation history or all messages from a thread in Griptape Cloud. Supports pagination for threads with many messag
  - body: { page?: integer, page_size?: integer, thread_id: string }
- `POST https://api.mcp.ai/api/griptape/list/threads` — Tool to list all threads. Use to retrieve available conversation threads in Griptape Cloud with optional filters and pagination.
  - body: { page?: integer, alias?: string, page_size?: integer, created_by?: string, starts_with?: string }
- `POST https://api.mcp.ai/api/griptape/list/tool/deployments` — Tool to list all deployments for a specific tool. Use when you need to retrieve deployment history and status for a tool in Griptape Cloud.
  - body: { page?: integer, tool_id: string, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/tool/runs` — Tool to list all runs for a specific tool with optional pagination and status filtering. Use when you need to retrieve historical execution runs for a tool.
  - body: { page?: integer, status?: string[], tool_id: string, page_size?: integer }
- `POST https://api.mcp.ai/api/griptape/list/users` — Tool to list all users in Griptape Cloud. Use after authenticating to retrieve available users.
- `POST https://api.mcp.ai/api/griptape/query/knowledge/base` — Performs semantic search against a Griptape Cloud knowledge base using natural language. Returns matching entries with similarity scores and metadata. Use this when you need to retrieve raw vector sea
  - body: { query: string, query_args?: object, knowledge_base_id: string }
- `POST https://api.mcp.ai/api/griptape/query/retriever` — Tool to query a retriever in Griptape Cloud with a natural-language query. Use when you need to retrieve information using a configured retriever, which may include reranking and multi-knowledge-base 
  - body: { query: string, retriever_id: string, retriever_components_query_args?: object }
- `POST https://api.mcp.ai/api/griptape/ruleset/creation` — Creates a new ruleset in Griptape Cloud. Rulesets are containers for rules that define behavioral guidelines for AI assistants. After creation, you can add rules to the ruleset and attach it to assist
  - body: { name: string, metadata?: object }
- `POST https://api.mcp.ai/api/griptape/search/knowledge/base` — Searches a Griptape Cloud Knowledge Base with a natural-language query and returns a synthesized answer. Use this tool when you need to: - Retrieve information from a specific knowledge base using nat
  - body: { query: string, knowledge_base_id: string }
- `POST https://api.mcp.ai/api/griptape/tool/creation` — Create a new tool resource in Griptape Cloud. Use this to register a new tool that can be configured and deployed later. The tool code can be added via the Griptape Cloud console after creation.
  - body: { name: string, description?: string }
- `POST https://api.mcp.ai/api/griptape/tool/deployment/status/retrieval` — Tool to retrieve status of a specific tool deployment. Use after creating a deployment to poll its progress.
  - body: { tool_id: string, deployment_id: string }
- `POST https://api.mcp.ai/api/griptape/tool/listing` — Tool to list all tools. Use when you need to discover available tools and their IDs in Griptape Cloud.
- `POST https://api.mcp.ai/api/griptape/update/assistant` — Tool to update an existing assistant's configuration. Use when you need to modify an assistant's name, description, model, or attached resources like knowledge bases, rulesets, structures, or tools.
  - body: { name?: string, input?: string, model?: string, tool_ids?: string[], description?: string, ruleset_ids?: string[], assistant_id: string, structure_ids?: string[], knowledge_base_ids?: string[] }
- `POST https://api.mcp.ai/api/griptape/update/bucket` — Tool to update a bucket's properties by its ID. Use when you need to modify bucket details such as the name in Griptape Cloud.
  - body: { name?: string, bucket_id: string }
- `POST https://api.mcp.ai/api/griptape/update/data/connector` — Tool to update a data connector's configuration in Griptape Cloud. Use when you need to modify an existing data connector's name, description, schedule, or configuration settings.
  - body: { name?: string, config?: object, description?: string, data_connector_id: string, schedule_expression?: string }
- `POST https://api.mcp.ai/api/griptape/update/function` — Tool to update an existing function's configuration. Use when you need to modify a function's name, description, code configuration, environment variables, or configuration file path.
  - body: { code?: object, name?: string, env_vars?: object[], description?: string, function_id: string, function_config_file?: string }
- `POST https://api.mcp.ai/api/griptape/update/integration` — Tool to update an existing integration's configuration. Use when you need to modify an integration's name, description, type, configuration, or associated resources like assistants and structures.
  - body: { name?: string, type?: string, config?: object, description?: string, assistant_ids?: string[], structure_ids?: string[], integration_id: string }
- `POST https://api.mcp.ai/api/griptape/update/knowledge/base` — Tool to update a knowledge base's configuration in Griptape Cloud. Use when you need to modify a knowledge base's type, config, description, name, embedding model, or other properties.
  - body: { name?: string, type?: string, config?: object, transforms?: object[], asset_paths?: string[], description?: string, embedding_model?: string, knowledge_base_id: string, schedule_expression?: string, use_default_embedding_model?: boolean }
- `POST https://api.mcp.ai/api/griptape/update/library` — Tool to update an existing library's configuration in Griptape Cloud. Use when you need to modify a library's name, description, data connectors, or knowledge base configurations.
  - body: { name: string, library_id: string, description?: string, data_connector_ids: string[], knowledge_base_configs: object[] }
- `POST https://api.mcp.ai/api/griptape/update/message` — Tool to update a message's input, output, and metadata by its ID. Use when you need to modify message content or associated metadata in Griptape Cloud.
  - body: { input?: string, output?: string, metadata?: object, message_id: string }
- `POST https://api.mcp.ai/api/griptape/update/model` — Tool to update a model configuration's properties by its ID. Use when you need to modify model details such as name, description, type, authentication settings, or activation status in Griptape Cloud.
  - body: { active?: boolean, kwargs?: object, model_name?: string, model_type?: string, description?: string, auth_config_id?: string, model_config_id: string }
- `POST https://api.mcp.ai/api/griptape/update/model/auth/config` — Tool to update an existing model auth config's properties. Use when you need to modify a model authentication configuration's name, API key secret, base URL, or additional kwargs in Griptape Cloud.
  - body: { name?: string, kwargs?: object, base_url?: string, auth_config_id: string, api_key_secret_id?: string }
- `POST https://api.mcp.ai/api/griptape/update/organization` — Tool to update an organization's properties by its ID. Use when you need to modify organization details such as the name or model configuration settings in Griptape Cloud.
  - body: { name?: string, model_config?: object, organization_id: string }
- `POST https://api.mcp.ai/api/griptape/update/retriever` — Tool to update an existing retriever's configuration in Griptape Cloud. Use when you need to modify a retriever's name, description, or associated retriever components.
  - body: { name?: string, description?: string, retriever_id: string, retriever_components?: object[], retriever_component_ids?: string[] }
- `POST https://api.mcp.ai/api/griptape/update/retriever/component` — Tool to update a retriever component's configuration by its ID. Use when you need to modify properties such as name, description, type, or configuration of a retriever component in Griptape Cloud.
  - body: { name?: string, type: string, config: object, description?: string, retriever_component_id: string }
- `POST https://api.mcp.ai/api/griptape/update/rule` — Tool to update an existing rule's configuration. Use when you need to modify a rule's name, content, or metadata.
  - body: { name?: string, rule?: string, rule_id: string, metadata?: object }
- `POST https://api.mcp.ai/api/griptape/update/ruleset` — Tool to update an existing ruleset's configuration. Use when you need to modify a ruleset's name, description, alias, rules, or metadata.
  - body: { name?: string, alias?: string, metadata?: object, rule_ids?: string[], ruleset_id: string, description?: string }
- `POST https://api.mcp.ai/api/griptape/update/secret` — Tool to update a secret's properties by its ID. Use when you need to modify secret details such as the name or value in Griptape Cloud.
  - body: { name?: string, value?: string, secret_id: string }
- `POST https://api.mcp.ai/api/griptape/update/structure` — Tool to update an existing structure's configuration. Use when you need to modify a structure's name, description, code configuration, environment variables, or webhook settings.
  - body: { code?: object, name?: string, env_vars?: object[], description?: string, structure_id: string, webhook_enabled?: boolean, structure_config_file?: string }
- `POST https://api.mcp.ai/api/griptape/update/thread` — Tool to update an existing thread's configuration. Use when you need to modify a thread's name, alias, metadata, or messages in Griptape Cloud.
  - body: { name?: string, alias?: string, messages?: object[], metadata?: object, thread_id: string }
- `POST https://api.mcp.ai/api/griptape/update/tool` — Tool to update an existing tool's configuration. Use when you need to modify a tool's name, description, code configuration, environment variables, or configuration file path.
  - body: { code?: object, name?: string, tool_id: string, env_vars?: object[], description?: string, tool_config_file?: string }

## Example prompts
- "What can I do in Griptape?"
- "Show me a summary of my Griptape account"

## More
- Page: https://mcp.ai/griptape
- Agent spec (llms.txt): https://mcp.ai/griptape/llms.txt
- Postman collection: https://mcp.ai/griptape/postman.json