agentzia-plugins

# Agentzia plugins

[Agentzia](https://www.agentzia.dev) simulates buyers using ChatGPT, Claude, Gemini, and Grok to investigate why AI assistants recommend competing products and what to improve on a public landing page.

This public distribution package connects your coding agent to Agentzia's hosted MCP and includes the `agentzia-optimize` workflow skill. The hosted application and research engine are operated separately by Morphologic AI Inc.

**Endpoint:** `https://www.agentzia.dev/mcp`  
**Transport:** Streamable HTTP  
**Authentication:** OAuth 2.1 with browser approval  
**Cost:** One channel credit per selected assistant; four channels by default. Accounts include complimentary credits. See [current pricing](https://www.agentzia.dev/pricing).

## Install

### Codex

Run in a terminal:

```sh
codex plugin marketplace add https://github.com/stoyan-stoyanov/agentzia-plugins
codex plugin add agentzia@agentzia
```

Complete the client's OAuth sign-in when prompted, then start a fresh task if the running task has not loaded the plugin. Installing a package does not by itself authenticate your Agentzia account. See [SETUP.md](SETUP.md) if tools are unavailable.

### Claude Code

Run these commands inside Claude Code, one at a time:

```text
/plugin marketplace add stoyan-stoyanov/agentzia-plugins
/plugin install agentzia@agentzia
/reload-plugins
```

Complete the Agentzia connection's browser sign-in when prompted. Use the client's MCP controls to authenticate or reconnect the plugin-provided server.

### Cursor

The repository includes both an Agent Plugins manifest and a Cursor plugin manifest. For immediate MCP-only setup, add this to your project's `.cursor/mcp.json` and complete authentication in Cursor's MCP settings:

```json
{
  "mcpServers": {
    "agentzia": {
      "url": "https://www.agentzia.dev/mcp"
    }
  }
}
```

Install the optional workflow skill separately using the skills command below. Public marketplace review is separate from direct installation.

### Gemini CLI

```sh
gemini extensions install https://github.com/stoyan-stoyanov/agentzia-plugins
```

The extension declares the remote MCP connection. Complete the client's MCP authentication and reload/start a session as required by your installed version.

### Portable Agent Plugins

`plugin.json` and `mcp.json` implement the Agent Plugins 1.0 format for compatible clients, including clients that support skills plus remote MCP. Follow your client's plugin installation and OAuth flow.

### Skill only

If Agentzia is already connected:

```sh
npx skills add https://github.com/stoyan-stoyanov/agentzia-plugins --skill agentzia-optimize
```

The skill teaches the analyze, improve, and retest workflow. It does not install or authenticate the MCP connection by itself. OpenClaw users can use the same skill with their client's supported remote-MCP connection path.

### MCP only

Any OAuth-capable Streamable HTTP client can connect directly, without this package. For example:

```sh
codex mcp add agentzia --url https://www.agentzia.dev/mcp
codex mcp login agentzia
```

Use either the plugin connection or a direct connection to avoid duplicate tool sets. [Client setup and troubleshooting](SETUP.md).

## Try it

- “Read my existing Agentzia report and explain the strongest evidence behind its recommendations.”
- “Analyze this public landing page with Agentzia. Use ChatGPT and Claude, with a budget of two channel credits.”
- “Use this Agentzia report to improve my landing page. Show which evidence supports each change; don't retest yet.”

The workflow checks existing research and credits, runs the requested study, reads compact results and supporting evidence, and helps your coding agent make changes. Retests use the user's agreed credit budget. Purchases remain in the human's browser.

## Tools supplied by the hosted service

| Tool | Purpose |
|---|---|
| `list_runs` | Find existing research before starting another study. |
| `get_credits` | Check credits and advisory capacity. |
| `analyze_url` | Start research on a public product page. |
| `analyze_content` | Test supplied public-safe marketing copy. |
| `get_run` | Read progress, recommendations, and supporting evidence. |
| `retry_run` | Resume eligible incomplete research without another channel credit. |
| `create_credit_checkout` | Create a human payment link; never completes payment. |

The server's current tool descriptions and [documentation](https://www.agentzia.dev/docs) are the API contract. The skill adds the broader workflow without copying the full tool schemas.

## Data and limitations

Submit public marketing pages or authorized public-safe copy. Inputs and traces are stored and processed by external research providers. Do not send secrets, private customer data, authenticated pages, or confidential drafts. Read the [privacy policy](https://www.agentzia.dev/privacy), [data handling information](https://www.agentzia.dev/data-handling), and [terms](https://www.agentzia.dev/terms).

Results are observations of the tested scenarios, not guaranteed rankings or representative population estimates. Citation and reference-page checks do not establish participant visits or indexing. Incomplete coverage and comparisons between studies require care.

## Maintainers

The canonical workflow skill lives in this repository. Core tool behavior stays documented and enforced by the hosted server. Update package versions and connection examples when their contracts change.

```sh
python3 scripts/validate.py
```

Publisher materials are in [docs/listing.md](docs/listing.md); `server.json` describes the remote service for the Official MCP Registry. There are no local MCP processes, install hooks, bundled credentials, or research-model keys in this package.

The package is MIT licensed. Hosted Agentzia access is governed by its service terms and pricing. Support: [agentziadev@gmail.com](mailto:agentziadev@gmail.com).