# Kovca

> Kovca is a freemium MCP server for developer tools. Build, test, publish and run Kovca workflows from an agent with a workspace API key. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://kovca.io/docs/mcp
- **MCP Registry name:** io.kovca/mcp
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-15

## About

Kovca's server lets a coding agent work on the same drafts and runs as the Studio and the Workflows API. An agent can list and read workflows, run a published version, follow a run step by step, and look at 30-day usage, then, with higher access, create drafts, add nodes, set triggers, validate and test them. Publish access adds publishing, activating or pausing automations, and cancelling runs.

The API key's access level decides which tools appear. Edits carry a base_revision and fail with REVISION_CONFLICT if the draft changed meanwhile, so an agent cannot overwrite a Studio edit. Published versions never change. Signing in to an app always needs a person: connect_app returns a link, and agents never see tokens or credentials.

Published workflows can be exposed as their own wf_<name> tools, up to 50 per workspace. The server uses stateless Streamable HTTP with a bearer key; hosted clients that need OAuth cannot connect yet. Requests are limited to 120 a minute per workspace, and runs are billed like API calls.

## Features

- **Tiered access:** Run, Author and Publish key levels decide which tools an agent sees.
- **Draft editing:** Create workflows, add nodes, set triggers and apply batched edits.
- **Test and validate:** Validate drafts and test them before publishing.
- **Run monitoring:** Inspect run steps, failures, waits and 30-day usage.
- **Workflows as tools:** Expose a published workflow as its own wf_ tool.
- **Conflict protection:** Revision checks stop agents overwriting newer edits.

## Good for

- Have an agent build a draft workflow from a template
- Run a published workflow and follow its steps
- Find why a run failed and retry its event
- Pause or activate an automation without opening the Studio

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://kovca.io/api/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://kovca.io/api/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://kovca.io/api/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://kovca.io/api/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://kovca.io/api/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://kovca.io/api/v1/mcp"
    }
  }
}
```

## Tools

- `list_workflows`: List workflows with latest version and draft revision.
- `get_workflow`: Published versions and their schemas.
- `run_workflow`: Run a published version.
- `get_run`: Run status and steps.
- `list_runs`: Runs from the last 30 days and waiting runs.
- `get_workflow_usage`: Usage over the last 30 days.
- `retry_run`: Re-run an automation run's app event.
- `list_waits`: Open approvals, delays and callbacks.
- `list_templates`: List templates.
- `list_nodes`: List nodes.
- `get_node_spec`: Input, output and config schemas for a node.
- `list_connectors`: Apps with their triggers and actions.
- `list_connections`: Workspace connections and app accounts.
- `connect_app`: Start connecting an app account.
- `create_workflow`: Create a new draft.
- `rename_workflow`: Rename a workflow.
- `edit_workflow`: Apply a batch of edits at a base revision.
- `add_node`: Add a node to a draft.
- `get_library`: The node library shown in the Studio.
- `set_trigger`: Set what starts a workflow.
- `use_node_version`: Pin a draft to another node version.
- `validate_workflow`: Validation issues blocking publishing.
- `test_workflow`: Run the draft as a Studio test.
- `list_custom_nodes`: List custom nodes.
- `get_custom_node`: Read a custom node.
- `create_custom_node`: Create a custom node.
- `edit_custom_node`: Edit a custom node.
- `test_custom_node`: Test a custom node.
- `publish_workflow`: Publish a draft as the next version.
- `publish_custom_node`: Publish a custom node.
- `activate_automation`: Start an automation on a version.
- `pause_automation`: Pause an automation.
- `resume_automation`: Resume an automation.
- `deactivate_automation`: Turn an automation off.
- `set_workflow_enabled`: Turn a workflow off or on.
- `archive_workflow`: Archive a workflow.
- `decide_wait`: Approve or reject a waiting run's approval.
- `reply_to_agent`: Answer a coding agent that stopped to ask.
- `cancel_run`: Cancel a waiting run.

## FAQ

### How do I authenticate?

Send a workspace API key as a bearer token; OAuth-only hosted clients cannot connect yet.

### How is usage billed?

Runs and actions use credits at $0.001 each, with 5,000 free credits a month on the first workspace.

### What stays with a person?

Signing in to apps, HTTP connections, keys, webhooks and billing.

### What is the rate limit?

120 MCP requests a minute per workspace.

### Is Kovca free?

Kovca has a free plan, with paid plans for more usage or features.

### How do I add Kovca to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://kovca.io/api/v1/mcp

### What are the best alternatives to Kovca?

The closest alternatives to Kovca are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/kovca
