SKILL.md

---
name: control-extract-operations
description: Use Control Extract for account health, connector inventory, pipeline listings, connection details, and run history.
---

# Control Extract Operations

Use this skill when the user asks about Extract account status, configured
connectors, sources, destinations, pipelines, connection details, or recent run
history.

The plugin exposes one MCP server:

- `control-extract` at `https://api.extract.to/mcp-account`, displayed as Control Extract.

Extract documentation: https://docs.extract.to/

## Tools

Use these `control-extract` tools:

- `account_summary` - summarize account connectors and connections.
- `list_connectors` - list all account connectors, sources, and destinations.
- `search_connectors` - filter account connectors by name, type, or platform.
- `get_connector` - inspect one configured connector.
- `list_connections` - list pipelines.
- `search_connections` - find pipelines by source, destination, or status.
- `get_connection` - inspect one pipeline.
- `list_connection_runs` - list recent runs for a pipeline.

## Workflows

### Account Health

Use the `account_summary` tool on `control-extract` for account status, pipeline health,
active connections, disabled connections, and error counts.

### Connector Inventory

Use the `list_connectors` tool on `control-extract` for a broad source/destination inventory.
Use the `search_connectors` tool on `control-extract` when the user provides a connector name,
type, or platform filter.

### Pipeline Details

Use the `list_connections` tool on `control-extract` for broad pipeline discovery. Use
the `search_connections` tool on `control-extract` when the user provides a source,
destination, status, or name filter. Then call the `get_connection` tool
on `control-extract`
before answering detailed questions about one pipeline.

### Run History

Use the `list_connection_runs` tool on `control-extract` after identifying the connection.

## Safety Rules

- Do not expose credentials, tokens, secrets, or unnecessary PII.
- Do not guess connector ids or connection ids.
- If multiple connectors or connections match, ask the user to choose one.
- Use the setup skill for creating sources, destinations, connections, schedule
  changes, stream selection, or sample data.
- Do not use this plugin for SQL analysis, schema discovery, or metadata editing;
  this plugin is account-MCP-only.