Skip to content

Tricentis/mcp-skills / Tosca/Cloud/CLI/claude/skills/tosca-cloud

tosca-cloud

Verified

Automates Tosca Cloud via toscactl (default) and tn for CLI gaps. Use for Tosca Cloud CLI, toscactl commands, or tn --loop for Builder/DI/mobile gaps. Does NOT cover on-prem Commander (use Tosca.Commander.IDE.integration).

FileKindSize
CHANGELOG.mdmarkdown458 B
LICENSEother275 B
SKILL.mdskill md4.0 KB
apiexecution-orchestration.mdmarkdown1.0 KB
builder-orchestration.mdmarkdown1.6 KB
di-orchestration.mdmarkdown5.0 KB
execution-orchestration.mdmarkdown1.2 KB
inventory-orchestration.mdmarkdown1.1 KB
journeys-index.mdmarkdown1.9 KB
metadata.jsonconfig137 B
mobile-orchestration.mdmarkdown1.4 KB
path-selection.mdmarkdown1.4 KB
playlist-orchestration.mdmarkdown1.8 KB
reference/di/conventions.mdmarkdown1.4 KB
reference/di/index.mdmarkdown788 B
reference/di/overview.mdmarkdown1013 B
reference/di/workflows/01-row-by-row-comparison.mdmarkdown7.3 KB
reference/di/workflows/02-file-comparison.mdmarkdown660 B
reference/manifest.jsonconfig2.2 KB
reference/tools-catalog.mdmarkdown16.6 KB
reference/tools-index.mdmarkdown2.1 KB
reference/workflows-index.mdmarkdown2.0 KB
reference/workflows/analyze-run-failures.mdmarkdown576 B
reference/workflows/api-execution-connection.mdmarkdown643 B
reference/workflows/connect-tenant.mdmarkdown878 B
reference/workflows/create-playlist.mdmarkdown608 B
reference/workflows/deploy-simulation.mdmarkdown580 B
reference/workflows/di-db-expert-testcase.mdmarkdown755 B
reference/workflows/di-getting-started.mdmarkdown1.8 KB
reference/workflows/inspect-space.mdmarkdown835 B
reference/workflows/loop-autonomous.mdmarkdown1.2 KB
reference/workflows/manage-api-message.mdmarkdown684 B
reference/workflows/manage-folder.mdmarkdown1.4 KB
reference/workflows/mobile-connection.mdmarkdown724 B
reference/workflows/rename-playlist-items.mdmarkdown750 B
reference/workflows/robot-monitoring.mdmarkdown1.2 KB
reference/workflows/run-playlist.mdmarkdown576 B
reference/workflows/scaffold-test-case.mdmarkdown1.8 KB
reference/workflows/search-artifacts.mdmarkdown616 B
runtime-routing.mdmarkdown1.8 KB
simulation-orchestration.mdmarkdown993 B
space-orchestration.mdmarkdown1.8 KB
tn-invocation.mdmarkdown2.0 KB
tool-orchestration.mdmarkdown6.5 KB
tool-planning.mdmarkdown3.4 KB
toscactl-invocation.mdmarkdown2.1 KB
when-to-use-mcp.mdmarkdown4.9 KB

tool-planning.md

View on GitHub
# MCP tool planning guide

Use with [tn-invocation.md](tn-invocation.md), [tool-orchestration.md](tool-orchestration.md), and [reference/tools-catalog.md](reference/tools-catalog.md) — open the catalog only for tools in your plan.

## Planning checklist

```text
Plan checklist:
- [ ] Goal stated in Cloud terms (tenant, space, artifact, playlist)
- [ ] Readiness: tosca_organization_listWorkspaces
- [ ] Discover before every mutation
- [ ] Async poll steps identified (DI schema, playlist runs)
- [ ] Destructive steps flagged for user confirmation
- [ ] Verify step at end
```

## Planning primitives

### Resolve identity

Cloud artifacts use **EntityId** from inventory search.

```
tosca_inventory_search(artifactType, artifactName, folderEntityId?)
  → EntityId for downstream tools
```

Prefer `tosca_inventory_advancedSearch` when filters are complex or results paginate.

### Playlist resolution

```
tosca_playlist_searchByName(name)
  → playlistId

tosca_execution_getPlaylistIdsByName(name)   # id-only, read-only
```

### Run polling

```
tosca_playlist_run(playlistId) → runId
tosca_playlist_getRecentRuns(playlistId, limit)
  → repeat until state ∉ {Running, ...}
```

Only then `tosca_playlist_getFailedTestSteps` for failed runs.

### DI async chain

```
tosca_dataintegrity_getConnectionSchema(connectionId) → notificationId
tosca_dataintegrity_checkSchemaResult(notificationId) → poll until complete
```

Same pattern for `testConnection` / `checkTestConnectionResult`.

### Builder scaffold chain

```
tosca_builder_getModulesSummary
tosca_inventory_search(artifactType: module)   # if moduleName ambiguous
tosca_builder_scaffoldTestCase(name, testSteps?)
tosca_inventory_move(artifactIds, folderEntityId)
```

## Category-specific plans

### Space audit (read-only)

See [reference/workflows/inspect-space.md](reference/workflows/inspect-space.md).

### Connect tenant

See [reference/workflows/connect-tenant.md](reference/workflows/connect-tenant.md) and journey skill `tosca-cloud-connect`.

### Search artifacts

See [reference/workflows/search-artifacts.md](reference/workflows/search-artifacts.md).

### Run and analyze playlist

```
run-playlist.md → analyze-run-failures.md
```

Or journey skill `tosca-analyzing-execution-results`.

### Manage folders

See [reference/workflows/manage-folder.md](reference/workflows/manage-folder.md).

### Data Integrity

```
di-orchestration.md + one reference/di/workflows/*.md
tosca_dataintegrity_workflow
listConnections → schema (async) → createRowByRowComparison
```

**Never** call DI mutate tools before reading `tosca_dataintegrity_workflow` output.

### Mobile / API / simulation

| Scenario | Workflow |
|----------|----------|
| Mobile connection | [mobile-connection.md](reference/workflows/mobile-connection.md) |
| API execution connection | [api-execution-connection.md](reference/workflows/api-execution-connection.md) |
| Simulation deploy | [deploy-simulation.md](reference/workflows/deploy-simulation.md) |

## Error recovery

| Signal | Plan adjustment |
|--------|-------------------|
| 401 | Re-auth via `tn`; see `tosca-cloud-connect` |
| Entitlement error | Stop; inform user |
| Empty search | Broaden filters or ask user |
| DI async incomplete | Continue polling check*Result |
| Wrong entityId | Re-search inventory |

## Journey vs engineering

| Need | Use |
|------|-----|
| Tool order, polling, parameters | `tosca-cloud` (this skill) |
| User-story diagnose/author/explain | Journey skills — `AGENTS.md` |
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall