diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index ef3ae0fe..5be5bc62 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -86,6 +86,12 @@ "source": "./skills/hugging-face-vision-trainer", "skills": "./", "description": "Train and fine-tune object detection models (RTDETRv2, YOLOS, DETR and others) and image classification models (timm and transformers models — MobileNetV3, MobileViT, ResNet, ViT/DINOv3) using Transformers Trainer API on Hugging Face Jobs infrastructure or locally. Includes COCO dataset format support, Albumentations augmentation, mAP/mAR metrics, trackio tracking, hardware selection, and Hub persistence." + }, + { + "name": "civic-mcp-gateway", + "source": "./skills/civic-mcp-gateway", + "skills": "./", + "description": "Connect AI agents to 85+ tools (Gmail, Google Calendar, PostgreSQL, Slack, and more) through Civic's MCP Gateway with guardrails, scoped permissions, audit trails, and revocable access." } ] } diff --git a/README.md b/README.md index c48dbfac..797fdce2 100644 --- a/README.md +++ b/README.md @@ -89,6 +89,7 @@ This repository contains a few skills to get you started. You can also contribut | Name | Description | Documentation | |------|-------------|---------------| +| `civic-mcp-gateway` | Connect AI agents to 85+ tools (Gmail, Google Calendar, PostgreSQL, Slack, and more) through Civic's MCP Gateway with guardrails, scoped permissions, audit trails, and revocable access. | [SKILL.md](skills/civic-mcp-gateway/SKILL.md) | | `gradio` | Build Gradio web UIs and demos in Python. Use when creating or editing Gradio apps, components, event listeners, layouts, or chatbots. | [SKILL.md](skills/huggingface-gradio/SKILL.md) | | `hf-cli` | Execute Hugging Face Hub operations using the hf CLI. Download models/datasets, upload files, manage repos, and run cloud compute jobs. | [SKILL.md](skills/hf-cli/SKILL.md) | | `hugging-face-dataset-viewer` | Explore, query, and extract data from any Hugging Face dataset using the Dataset Viewer REST API and npx tooling. Zero Python dependencies — covers split/config discovery, row pagination, text search, filtering, SQL via parquetlens, and dataset upload via CLI. | [SKILL.md](skills/hugging-face-dataset-viewer/SKILL.md) | diff --git a/agents/AGENTS.md b/agents/AGENTS.md index fca1d877..daec495e 100644 --- a/agents/AGENTS.md +++ b/agents/AGENTS.md @@ -3,6 +3,7 @@ You have additional SKILLs documented in directories containing a "SKILL.md" file. These skills are: + - civic-mcp-gateway -> "skills/civic-mcp-gateway/SKILL.md" - gradio -> "skills/huggingface-gradio/SKILL.md" - hf-cli -> "skills/hf-cli/SKILL.md" - hugging-face-dataset-viewer -> "skills/hugging-face-dataset-viewer/SKILL.md" @@ -21,6 +22,7 @@ IMPORTANT: You MUST read the SKILL.md file whenever the description of the skill +civic-mcp-gateway: `"Connect AI agents to 85+ tools (Gmail, Google Calendar, PostgreSQL, Slack, and more) through Civic's MCP Gateway with guardrails, scoped permissions, audit trails, and revocable access. Civic separates the permission layer from the AI agent so they can't get around restrictions."` gradio: `Build Gradio web UIs and demos in Python. Use when creating or editing Gradio apps, components, event listeners, layouts, or chatbots.` hf-cli: `"Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing repositories, models, datasets, and Spaces on the Hugging Face Hub. Replaces now deprecated `huggingface-cli` command."` hugging-face-dataset-viewer: `Use this skill for Hugging Face Dataset Viewer API workflows that fetch subset/split metadata, paginate rows, search text, apply filters, download parquet URLs, and read size or statistics.` diff --git a/skills/civic-mcp-gateway/SKILL.md b/skills/civic-mcp-gateway/SKILL.md new file mode 100644 index 00000000..4ec4bd83 --- /dev/null +++ b/skills/civic-mcp-gateway/SKILL.md @@ -0,0 +1,50 @@ +--- +name: civic-mcp-gateway +description: "Connect AI agents to 85+ tools (Gmail, Google Calendar, PostgreSQL, Slack, and more) through Civic's MCP Gateway with guardrails, scoped permissions, audit trails, and revocable access. Civic separates the permission layer from the AI agent so they can't get around restrictions." +--- + +# Civic MCP Gateway + +Connect to Civic's MCP Gateway for identity, authorization, audit trails, and revocable access when calling MCP tools. + +## MCP Server Configuration + +```json +{ + "mcpServers": { + "civic": { + "url": "https://app.civic.com/hub/mcp" + } + } +} +``` + +**Claude Code:** +```bash +claude mcp add --transport http civic https://app.civic.com/hub/mcp +``` + +## Setup + +1. Sign up at https://app.civic.com and generate a bearer token +2. Configure the MCP server above in your agent's settings +3. On first connection, complete the OAuth flow in your browser + +## What it does + +- **85+ MCP servers** — Gmail, Google Calendar, PostgreSQL, Slack, and more available through a single gateway +- **Guardrails** — block destructive operations, redact PII from responses, enforce rate limits +- **Audit trail** — every tool call logged with agent identity and timestamp +- **Scoped permissions** — grant agents access to specific tools only +- **Revocable access** — revoke a token and the agent loses access immediately + +## Guardrail examples + +- Block Gmail sends containing secrets or to external domains +- Enforce read-only PostgreSQL access (block DROP, DELETE, ALTER) +- Redact PII from tool responses before they enter agent context +- Prevent bulk operations and enforce rate limits + +## Documentation + +Full docs at https://docs.civic.com/civic/quickstart