From e2149dec44cd9345ea1a9f2f69b82b846a8f06c9 Mon Sep 17 00:00:00 2001 From: Rishikesh Balaji Date: Thu, 13 Aug 2026 12:03:50 -0700 Subject: [PATCH] Use the resource gateway for resource tools --- plugins/shared/skills/resources_bigquery/SKILL.md | 2 +- plugins/shared/skills/resources_clerk/SKILL.md | 4 ++-- plugins/shared/skills/resources_clickhouse/SKILL.md | 2 +- plugins/shared/skills/resources_cosmosdb/SKILL.md | 2 +- plugins/shared/skills/resources_custom-api/SKILL.md | 2 +- plugins/shared/skills/resources_dynamodb/SKILL.md | 2 +- plugins/shared/skills/resources_fireflies/SKILL.md | 2 +- plugins/shared/skills/resources_gmail/SKILL.md | 2 +- plugins/shared/skills/resources_google-analytics/SKILL.md | 2 +- plugins/shared/skills/resources_googlecalendar/SKILL.md | 2 +- plugins/shared/skills/resources_googledrive/SKILL.md | 2 +- .../shared/skills/resources_googlesearchconsole/SKILL.md | 2 +- plugins/shared/skills/resources_googlesheets/SKILL.md | 2 +- plugins/shared/skills/resources_graphql/SKILL.md | 2 +- plugins/shared/skills/resources_hubspot/SKILL.md | 2 +- plugins/shared/skills/resources_lambda/SKILL.md | 2 +- plugins/shared/skills/resources_linkedin/SKILL.md | 2 +- plugins/shared/skills/resources_linkedinads/SKILL.md | 2 +- plugins/shared/skills/resources_list-resources/SKILL.md | 6 +++--- plugins/shared/skills/resources_majorauth/SKILL.md | 4 ++-- plugins/shared/skills/resources_managed-database/SKILL.md | 4 ++-- .../shared/skills/resources_managed-file-storage/SKILL.md | 2 +- plugins/shared/skills/resources_mcp_custom/SKILL.md | 2 +- plugins/shared/skills/resources_metamarketing/SKILL.md | 2 +- plugins/shared/skills/resources_mssql/SKILL.md | 2 +- plugins/shared/skills/resources_mysql/SKILL.md | 2 +- plugins/shared/skills/resources_neo4j/SKILL.md | 2 +- plugins/shared/skills/resources_notion/SKILL.md | 2 +- plugins/shared/skills/resources_outreach/SKILL.md | 2 +- plugins/shared/skills/resources_postgresql/SKILL.md | 2 +- plugins/shared/skills/resources_quickbooks/SKILL.md | 2 +- plugins/shared/skills/resources_s3/SKILL.md | 2 +- plugins/shared/skills/resources_salesforce/SKILL.md | 2 +- plugins/shared/skills/resources_sharepoint/SKILL.md | 2 +- plugins/shared/skills/resources_slack/SKILL.md | 6 +++--- plugins/shared/skills/resources_snowflake/SKILL.md | 2 +- plugins/shared/skills/resources_sqs/SKILL.md | 2 +- plugins/shared/skills/resources_stripe/SKILL.md | 2 +- plugins/shared/skills/resources_tiktokads/SKILL.md | 2 +- 39 files changed, 46 insertions(+), 46 deletions(-) diff --git a/plugins/shared/skills/resources_bigquery/SKILL.md b/plugins/shared/skills/resources_bigquery/SKILL.md index ddab831..6a4a680 100644 --- a/plugins/shared/skills/resources_bigquery/SKILL.md +++ b/plugins/shared/skills/resources_bigquery/SKILL.md @@ -11,7 +11,7 @@ description: Implements BigQuery dataset exploration, SQL queries, and table ope **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_clerk/SKILL.md b/plugins/shared/skills/resources_clerk/SKILL.md index 9fbf43b..30eebb1 100644 --- a/plugins/shared/skills/resources_clerk/SKILL.md +++ b/plugins/shared/skills/resources_clerk/SKILL.md @@ -11,7 +11,7 @@ description: Implements Clerk Backend API requests with automatic Bearer Token a **Three ways to interact with Clerk:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Clerk API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. @@ -57,7 +57,7 @@ await clerkClient.invoke("POST", "/v1/invitations", "create-invitation", { **Using MCP tools (no code needed):** -Call `mcp__resources__clerk_list_users` with the `emailAddress` filter: +Call `mcp__resources__clerk_list_users` via `mcp__resources__execute_resource_tool` with the `emailAddress` filter: ``` mcp__resources__clerk_list_users({ diff --git a/plugins/shared/skills/resources_clickhouse/SKILL.md b/plugins/shared/skills/resources_clickhouse/SKILL.md index a9e695b..8b314ef 100644 --- a/plugins/shared/skills/resources_clickhouse/SKILL.md +++ b/plugins/shared/skills/resources_clickhouse/SKILL.md @@ -11,7 +11,7 @@ description: Implements ClickHouse database connections, SQL queries, and data o **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_cosmosdb/SKILL.md b/plugins/shared/skills/resources_cosmosdb/SKILL.md index 2947465..b2a7d09 100644 --- a/plugins/shared/skills/resources_cosmosdb/SKILL.md +++ b/plugins/shared/skills/resources_cosmosdb/SKILL.md @@ -11,7 +11,7 @@ description: Implements Azure CosmosDB container queries, CRUD, and patch operat **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_custom-api/SKILL.md b/plugins/shared/skills/resources_custom-api/SKILL.md index 6059ce8..13b3265 100644 --- a/plugins/shared/skills/resources_custom-api/SKILL.md +++ b/plugins/shared/skills/resources_custom-api/SKILL.md @@ -11,7 +11,7 @@ description: Implements custom REST API HTTP requests with automatic auth header **Three ways to interact with Custom API:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Custom API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_dynamodb/SKILL.md b/plugins/shared/skills/resources_dynamodb/SKILL.md index 46c6797..d781951 100644 --- a/plugins/shared/skills/resources_dynamodb/SKILL.md +++ b/plugins/shared/skills/resources_dynamodb/SKILL.md @@ -11,7 +11,7 @@ description: Implements DynamoDB queries, scans, and CRUD operations using gener **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_fireflies/SKILL.md b/plugins/shared/skills/resources_fireflies/SKILL.md index 3e08ec9..afb586f 100644 --- a/plugins/shared/skills/resources_fireflies/SKILL.md +++ b/plugins/shared/skills/resources_fireflies/SKILL.md @@ -11,7 +11,7 @@ description: Implements Fireflies AI meeting transcription API access for transc **Three ways to interact with Fireflies:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Fireflies API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_gmail/SKILL.md b/plugins/shared/skills/resources_gmail/SKILL.md index 6925fa0..6ecdf20 100644 --- a/plugins/shared/skills/resources_gmail/SKILL.md +++ b/plugins/shared/skills/resources_gmail/SKILL.md @@ -24,7 +24,7 @@ Gmail requires OAuth authentication before use. **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_google-analytics/SKILL.md b/plugins/shared/skills/resources_google-analytics/SKILL.md index 2e70561..1297413 100644 --- a/plugins/shared/skills/resources_google-analytics/SKILL.md +++ b/plugins/shared/skills/resources_google-analytics/SKILL.md @@ -11,7 +11,7 @@ description: Implements Google Analytics (GA4) reporting, metadata exploration, **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_googlecalendar/SKILL.md b/plugins/shared/skills/resources_googlecalendar/SKILL.md index e08064d..3633d91 100644 --- a/plugins/shared/skills/resources_googlecalendar/SKILL.md +++ b/plugins/shared/skills/resources_googlecalendar/SKILL.md @@ -24,7 +24,7 @@ Google Calendar requires OAuth authentication before use. **Three ways to interact with Google Calendar:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Google Calendar API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_googledrive/SKILL.md b/plugins/shared/skills/resources_googledrive/SKILL.md index edcf0cf..da7968b 100644 --- a/plugins/shared/skills/resources_googledrive/SKILL.md +++ b/plugins/shared/skills/resources_googledrive/SKILL.md @@ -24,7 +24,7 @@ Google Drive requires OAuth authentication before use. **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_googlesearchconsole/SKILL.md b/plugins/shared/skills/resources_googlesearchconsole/SKILL.md index bc42003..0bad92f 100644 --- a/plugins/shared/skills/resources_googlesearchconsole/SKILL.md +++ b/plugins/shared/skills/resources_googlesearchconsole/SKILL.md @@ -13,7 +13,7 @@ Google Search Console is an OAuth-only connector. It accesses verified Search Co **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_googlesheets/SKILL.md b/plugins/shared/skills/resources_googlesheets/SKILL.md index 2db72ca..c5508ad 100644 --- a/plugins/shared/skills/resources_googlesheets/SKILL.md +++ b/plugins/shared/skills/resources_googlesheets/SKILL.md @@ -35,7 +35,7 @@ If you call a Google Sheets MCP tool and get an error indicating no spreadsheet **Three ways to interact with Google Sheets:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Google Sheets API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_graphql/SKILL.md b/plugins/shared/skills/resources_graphql/SKILL.md index f039d2c..c01f6e0 100644 --- a/plugins/shared/skills/resources_graphql/SKILL.md +++ b/plugins/shared/skills/resources_graphql/SKILL.md @@ -11,7 +11,7 @@ description: Executes GraphQL queries and mutations against a configured endpoin **Three ways to interact with this resource:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **Apollo Client via the HTTP proxy** (GraphQL-specific): Pass `createProxyFetch({ resourceId, ... })` as Apollo's `fetch` so the proxy resolves the endpoint and injects auth at request time. Use this when the app needs Apollo's normalized cache, optimistic updates, or fragments. See "Apollo Client via the HTTP Proxy" below. diff --git a/plugins/shared/skills/resources_hubspot/SKILL.md b/plugins/shared/skills/resources_hubspot/SKILL.md index 545d9c9..60733e2 100644 --- a/plugins/shared/skills/resources_hubspot/SKILL.md +++ b/plugins/shared/skills/resources_hubspot/SKILL.md @@ -11,7 +11,7 @@ description: Implements HubSpot CRM data access for contacts, companies, and dea **Three ways to interact with HubSpot:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the HubSpot API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_lambda/SKILL.md b/plugins/shared/skills/resources_lambda/SKILL.md index e14c558..e251bb8 100644 --- a/plugins/shared/skills/resources_lambda/SKILL.md +++ b/plugins/shared/skills/resources_lambda/SKILL.md @@ -11,7 +11,7 @@ description: Implements AWS Lambda function invocation and management using gene **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_linkedin/SKILL.md b/plugins/shared/skills/resources_linkedin/SKILL.md index 9bea4aa..5c6a750 100644 --- a/plugins/shared/skills/resources_linkedin/SKILL.md +++ b/plugins/shared/skills/resources_linkedin/SKILL.md @@ -13,7 +13,7 @@ Reference: https://learn.microsoft.com/en-us/linkedin/marketing/ **Three ways to interact with LinkedIn:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources__linkedin_`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources__linkedin_`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the LinkedIn Marketing API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_linkedinads/SKILL.md b/plugins/shared/skills/resources_linkedinads/SKILL.md index 23725f2..86a0039 100644 --- a/plugins/shared/skills/resources_linkedinads/SKILL.md +++ b/plugins/shared/skills/resources_linkedinads/SKILL.md @@ -11,7 +11,7 @@ description: Implements LinkedIn Marketing API data access for ad accounts, camp **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_list-resources/SKILL.md b/plugins/shared/skills/resources_list-resources/SKILL.md index 285be62..4393c8a 100644 --- a/plugins/shared/skills/resources_list-resources/SKILL.md +++ b/plugins/shared/skills/resources_list-resources/SKILL.md @@ -9,15 +9,15 @@ The application has been granted access to resources — external services (data ## Step 1: List available resources -Call `mcp__resources__list_resources` to get all resources the application has access to. +Call `mcp__resources__list_resources` via `mcp__resources__execute_resource_tool` to get all resources the application has access to. ## Step 2: Check for context documents before doing any work -**Always call `mcp__resources__list_resource_context` for every resource before doing any other work with it.** Resources often have context documents attached (API docs, schema references, usage guides) that tell you exactly how to use them. +**Always call `mcp__resources__list_resource_context` via `mcp__resources__execute_resource_tool` for every resource before doing any other work with it.** Resources often have context documents attached (API docs, schema references, usage guides) that tell you exactly how to use them. For each resource you plan to use: -1. Call `mcp__resources__list_resource_context` with the `resourceId` immediately after listing resources +1. Call `mcp__resources__list_resource_context` via `mcp__resources__execute_resource_tool` with the `resourceId` immediately after listing resources 2. **If documents exist, you MUST read them before doing anything else with the resource.** Do NOT skip this step. Do NOT query the resource directly until you have read all relevant context documents. The user uploaded these documents specifically to guide how you use the resource. 3. For each relevant document, spawn the `file-reader` agent to download and read it: ``` diff --git a/plugins/shared/skills/resources_majorauth/SKILL.md b/plugins/shared/skills/resources_majorauth/SKILL.md index 6016780..7c22f6a 100644 --- a/plugins/shared/skills/resources_majorauth/SKILL.md +++ b/plugins/shared/skills/resources_majorauth/SKILL.md @@ -9,7 +9,7 @@ description: Share or revoke application access for users by email. Use whenever **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. @@ -26,7 +26,7 @@ description: Share or revoke application access for users by email. Use whenever The Major Auth Connector is a **managed resource** that exists by default in every organization. To use it: -1. Call `mcp__resources__list_resources` to discover available resources — look for the one with subtype `majorauth` (named "Major Auth Connector"). +1. Call `mcp__resources__list_resources` via `mcp__resources__execute_resource_tool` to discover available resources — look for the one with subtype `majorauth` (named "Major Auth Connector"). 2. Call `mcp__resource-tools__add-resource-client` with that `resourceId` to generate a typed `MajorAuthResourceClient`. 3. Use the generated client in your app code to share or revoke access. diff --git a/plugins/shared/skills/resources_managed-database/SKILL.md b/plugins/shared/skills/resources_managed-database/SKILL.md index ea6e1f6..ff4935d 100644 --- a/plugins/shared/skills/resources_managed-database/SKILL.md +++ b/plugins/shared/skills/resources_managed-database/SKILL.md @@ -20,7 +20,7 @@ The `setup_managed_database` MCP tool creates **app-scoped** databases only. ## Setting Up a Managed Database -Call `mcp__resources__setup_managed_database` — no arguments needed. The tool automatically provisions a database for the current application. +Call `mcp__resources__setup_managed_database` via `mcp__resources__execute_resource_tool` — no arguments needed. The tool automatically provisions a database for the current application. **Behavior:** @@ -33,7 +33,7 @@ Call `mcp__resources__setup_managed_database` — no arguments needed. The tool After setup completes and you have the resource ID: -1. **MCP tools** (direct SQL, no code needed): +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): - `mcp__resources__postgresql_psql` — Read-only SQL queries and psql commands (`\dt`, `\d`, etc.). Args: `resourceId`, `command` - `mcp__orchestrator-platform__run_migration` — DDL/DML migrations (managed databases only). Args: `applicationId`, `migration`, `description` diff --git a/plugins/shared/skills/resources_managed-file-storage/SKILL.md b/plugins/shared/skills/resources_managed-file-storage/SKILL.md index c081c78..f7338bd 100644 --- a/plugins/shared/skills/resources_managed-file-storage/SKILL.md +++ b/plugins/shared/skills/resources_managed-file-storage/SKILL.md @@ -24,7 +24,7 @@ Once you have a `resourceId`, use it directly with the tools and client below. ## Using It Once Provisioned -1. **MCP tools** (direct, no code needed): +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): - `mcp__resources__blob_list` — list objects under a prefix. Args: `resourceId`, `prefix?`, `delimiter?`, `maxKeys?`, `continuationToken?` - `mcp__resources__blob_get` — read an object's body + metadata. Args: `resourceId`, `key` - `mcp__resources__blob_put` — write an object (`body` base64-encoded). Args: `resourceId`, `key`, `body`, `contentType?`, `cacheControl?`, `contentDisposition?` diff --git a/plugins/shared/skills/resources_mcp_custom/SKILL.md b/plugins/shared/skills/resources_mcp_custom/SKILL.md index 7d7b599..e6495fc 100644 --- a/plugins/shared/skills/resources_mcp_custom/SKILL.md +++ b/plugins/shared/skills/resources_mcp_custom/SKILL.md @@ -13,7 +13,7 @@ A custom MCP connector points at an external remote MCP server you bring. Its to **Two ways to interact with a custom MCP connector:** -1. **In-session MCP tools** (direct, no code needed): the connector is mounted as its own MCP server, so its tools are callable during the build as `mcp____`. Use `mcp__resources__list_resources` to find the connector and its `resourceId`. Call these tools to discover what the upstream server exposes and to test behavior. +1. **In-session MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): the connector is mounted as its own MCP server, so its tools are callable during the build as `mcp____`. Use `mcp__resources__list_resources` to find the connector and its `resourceId`. Call these tools to discover what the upstream server exposes and to test behavior. 2. **Generic MCP client** (for app code): import `createMcpClient` from `@major-tech/resource-client/next` and call `.callTool()`. There is **no per-resource generation step** — it's one client reused for any MCP connector; you just pass the `resourceId`. **CRITICAL: Do NOT guess tool names or argument shapes.** They are defined by the upstream MCP server, not by Major or by the client — `callTool(name, args)` is a single generic method with no per-tool typed methods. Discover the real tool names and arg shapes from the in-session `mcp____*` tools before wiring them into app code. diff --git a/plugins/shared/skills/resources_metamarketing/SKILL.md b/plugins/shared/skills/resources_metamarketing/SKILL.md index 0a1eec7..8984345 100644 --- a/plugins/shared/skills/resources_metamarketing/SKILL.md +++ b/plugins/shared/skills/resources_metamarketing/SKILL.md @@ -11,7 +11,7 @@ description: Implements Meta (Facebook) Marketing API access for campaigns, ads, **Three ways to interact with Meta Marketing:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Meta Marketing API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_mssql/SKILL.md b/plugins/shared/skills/resources_mssql/SKILL.md index ddd6112..e8bd5a1 100644 --- a/plugins/shared/skills/resources_mssql/SKILL.md +++ b/plugins/shared/skills/resources_mssql/SKILL.md @@ -11,7 +11,7 @@ description: Implements Microsoft SQL Server connections, queries, and schema ex **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_mysql/SKILL.md b/plugins/shared/skills/resources_mysql/SKILL.md index 09eceaf..37b54af 100644 --- a/plugins/shared/skills/resources_mysql/SKILL.md +++ b/plugins/shared/skills/resources_mysql/SKILL.md @@ -11,7 +11,7 @@ description: Implements MySQL database connections, SQL queries, and data operat **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_neo4j/SKILL.md b/plugins/shared/skills/resources_neo4j/SKILL.md index 4c28ec5..f24cb2d 100644 --- a/plugins/shared/skills/resources_neo4j/SKILL.md +++ b/plugins/shared/skills/resources_neo4j/SKILL.md @@ -11,7 +11,7 @@ description: Implements Neo4j Cypher queries, graph traversal, and node/relation **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_notion/SKILL.md b/plugins/shared/skills/resources_notion/SKILL.md index 48a5d13..bfa436b 100644 --- a/plugins/shared/skills/resources_notion/SKILL.md +++ b/plugins/shared/skills/resources_notion/SKILL.md @@ -11,7 +11,7 @@ description: Implements Notion API interactions for pages, databases, blocks, us **Three ways to interact with Notion:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Notion API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_outreach/SKILL.md b/plugins/shared/skills/resources_outreach/SKILL.md index 1418490..b801abd 100644 --- a/plugins/shared/skills/resources_outreach/SKILL.md +++ b/plugins/shared/skills/resources_outreach/SKILL.md @@ -11,7 +11,7 @@ description: Implements Outreach prospect and sequence management using generate **Three ways to interact with Outreach:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Outreach API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_postgresql/SKILL.md b/plugins/shared/skills/resources_postgresql/SKILL.md index dcc1124..90d5443 100644 --- a/plugins/shared/skills/resources_postgresql/SKILL.md +++ b/plugins/shared/skills/resources_postgresql/SKILL.md @@ -11,7 +11,7 @@ description: Implements PostgreSQL connections, SQL queries, and migration patte **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_quickbooks/SKILL.md b/plugins/shared/skills/resources_quickbooks/SKILL.md index 9b22979..6b03ada 100644 --- a/plugins/shared/skills/resources_quickbooks/SKILL.md +++ b/plugins/shared/skills/resources_quickbooks/SKILL.md @@ -11,7 +11,7 @@ description: Implements QuickBooks Online accounting data access for customers, **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_s3/SKILL.md b/plugins/shared/skills/resources_s3/SKILL.md index 50d6b02..c7215f5 100644 --- a/plugins/shared/skills/resources_s3/SKILL.md +++ b/plugins/shared/skills/resources_s3/SKILL.md @@ -11,7 +11,7 @@ description: Implements Amazon S3 object operations, presigned URLs, and file up **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_salesforce/SKILL.md b/plugins/shared/skills/resources_salesforce/SKILL.md index c0424da..0c9af2e 100644 --- a/plugins/shared/skills/resources_salesforce/SKILL.md +++ b/plugins/shared/skills/resources_salesforce/SKILL.md @@ -11,7 +11,7 @@ description: Implements Salesforce SOQL queries, sObject CRUD, and metadata expl **Three ways to interact with Salesforce:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Salesforce API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. diff --git a/plugins/shared/skills/resources_sharepoint/SKILL.md b/plugins/shared/skills/resources_sharepoint/SKILL.md index 4582ad7..79e8e96 100644 --- a/plugins/shared/skills/resources_sharepoint/SKILL.md +++ b/plugins/shared/skills/resources_sharepoint/SKILL.md @@ -11,7 +11,7 @@ description: Implements Microsoft SharePoint access — sites, lists, document l **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** Always read the actual client source code to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_slack/SKILL.md b/plugins/shared/skills/resources_slack/SKILL.md index 24820da..b4f855a 100644 --- a/plugins/shared/skills/resources_slack/SKILL.md +++ b/plugins/shared/skills/resources_slack/SKILL.md @@ -11,7 +11,7 @@ description: Implements Slack messaging, channel operations, and Web API calls u **Three ways to interact with Slack:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the Slack API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`. @@ -31,9 +31,9 @@ Before sending messages, posting files, or reading history from any channel, you **Required workflow:** -1. Call `mcp__resources__slack_list_channels` to get the list of channels the bot can see. +1. Call `mcp__resources__slack_list_channels` via `mcp__resources__execute_resource_tool` to get the list of channels the bot can see. 2. Check if the target channel appears in the results. -3. **If the channel is NOT in the list:** Tell the user that the bot does not currently have access to that channel. Ask them to invite the bot by going to the channel and @mentioning **@Major Slack Integration**. Once the user confirms they have done this, call `mcp__resources__slack_list_channels` again to verify the channel now appears. +3. **If the channel is NOT in the list:** Tell the user that the bot does not currently have access to that channel. Ask them to invite the bot by going to the channel and @mentioning **@Major Slack Integration**. Once the user confirms they have done this, call `mcp__resources__slack_list_channels` via `mcp__resources__execute_resource_tool` again to verify the channel now appears. 4. **Only after the channel is confirmed visible** in the list may you proceed with sending messages, reading history, or any other channel operation. **Do NOT skip this check.** Do NOT assume the bot has access to a channel just because the user mentioned it by name. diff --git a/plugins/shared/skills/resources_snowflake/SKILL.md b/plugins/shared/skills/resources_snowflake/SKILL.md index b2ed040..4464fd7 100644 --- a/plugins/shared/skills/resources_snowflake/SKILL.md +++ b/plugins/shared/skills/resources_snowflake/SKILL.md @@ -11,7 +11,7 @@ description: Implements Snowflake warehouse queries, schema exploration, and dat **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). **CRITICAL: Do NOT guess client method names or signatures.** The TypeScript clients in `@major-tech/resource-client` have strongly typed inputs and outputs. ALWAYS read the actual client source code in the generated `/clients/` directory (or the package itself) to verify available methods and their exact signatures before writing any client code. diff --git a/plugins/shared/skills/resources_sqs/SKILL.md b/plugins/shared/skills/resources_sqs/SKILL.md index fb344ae..880473a 100644 --- a/plugins/shared/skills/resources_sqs/SKILL.md +++ b/plugins/shared/skills/resources_sqs/SKILL.md @@ -14,7 +14,7 @@ description: Implements AWS SQS message queue operations for sending, receiving, **Two ways to interact with resources:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). diff --git a/plugins/shared/skills/resources_stripe/SKILL.md b/plugins/shared/skills/resources_stripe/SKILL.md index 944ecba..d5ba205 100644 --- a/plugins/shared/skills/resources_stripe/SKILL.md +++ b/plugins/shared/skills/resources_stripe/SKILL.md @@ -11,7 +11,7 @@ description: Implements Stripe payment API access for customers, payments, subsc **Three ways to interact with Stripe:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources___`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **Official Stripe SDK via the HTTP proxy** (Next.js apps): Pass `createProxyFetch` into `Stripe.createFetchHttpClient(...)`. See the **Stripe SDK via the HTTP proxy** section below — preferred when you want full Stripe SDK ergonomics (typed methods, autocomplete, automatic pagination). diff --git a/plugins/shared/skills/resources_tiktokads/SKILL.md b/plugins/shared/skills/resources_tiktokads/SKILL.md index 48940e7..7b10813 100644 --- a/plugins/shared/skills/resources_tiktokads/SKILL.md +++ b/plugins/shared/skills/resources_tiktokads/SKILL.md @@ -13,7 +13,7 @@ Reference: https://business-api.tiktok.com/portal/docs **Three ways to interact with TikTok Ads:** -1. **MCP tools** (direct, no code needed): Tools follow the pattern `mcp__resources__tiktokads_`. Use `mcp__resources__list_resources` to discover available resources and their IDs. +1. **MCP tools** (via `mcp__resources__execute_resource_tool`, no code needed): Tools follow the pattern `mcp__resources__tiktokads_`. Use `mcp__resources__list_resources` to discover available resources and their IDs. 2. **Generated TypeScript clients** (for app code): Call `mcp__resource-tools__add-resource-client` with a `resourceId` to generate a typed client. Clients are created in `/clients/` (Next.js) or `/src/clients/` (Vite). 3. **HTTP proxy** (Next.js apps): Use `createProxyFetch` from `@major-tech/resource-client/next` to call the TikTok Marketing API directly with automatic auth injection. See [using-http-proxy](../http-proxy/SKILL.md) for setup and usage — preferred when you need to hit endpoints not covered by MCP tools or the typed client, or when using an official SDK that accepts a custom `fetch`.