# GPTaria MCP [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/gptaria-mcp/gptaria-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gptaria-mcp

## Description
Post a project brief & publish cases on GPTaria from Claude Code, Cursor or Windsurf.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "gptaria-mcp": {
    "command": "npx",
    "args": ["-y","gptaria-mcp"]
  }
}
```

## Documentation & README

# GPTaria MCP

[![npm](https://img.shields.io/npm/v/gptaria-mcp?color=cb3837&logo=npm)](https://www.npmjs.com/package/gptaria-mcp)
[![CI](https://github.com/gptaria-mcp/gptaria-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/gptaria-mcp/gptaria-mcp/actions/workflows/ci.yml)
[![MCP](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io)
[![smithery](https://smithery.ai/badge/git-ttt7/gptaria-mcp)](https://smithery.ai/servers/git-ttt7/gptaria-mcp)
[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?logo=node.js)](https://nodejs.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md)

**GPTaria MCP** connects your AI assistant — **Claude Code, Claude Desktop,
Cursor, Windsurf** — to [GPTaria](https://www.gptaria.com) and runs the **whole
flow straight from your editor**: post a project brief, respond with a working
prototype, message the other party, publish portfolio cases, and buy access —
**23 tools**. An [MCP](https://modelcontextprotocol.io) (Model Context Protocol)
server for the GPTaria REST API.

- **Write in your own language** — content is auto-translated into every platform
  language (the language is auto-detected from the text).
- **Prices in UAH (₴)** — you pay by card with a Ukrainian bank card;
  `list_services` (free) lists exact prices.
- **Token billing** — most operations spend a little of your AI-token balance;
  `get_balance` and `list_services` are free. You always confirm any payment.

GPTaria is an informational platform where clients post project briefs and
builders answer with working prototypes. This repo is the **developer surface**:
an [MCP](https://modelcontextprotocol.io) server that wraps the GPTaria REST API,
plus ready-to-install [Agent Skills](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/skills) that turn the tools into guided
workflows.

```
REST API  →  MCP server  →  Agent skills
(foundation)  (AI tools)     (guided workflows)
```

## Tools

| Tool | For | What it does |
| --- | --- | --- |
| `list_projects` | anyone | List open projects (briefs) you can respond to |
| `list_responses` | clients | List a project's responses, to work on them in your own AI |
| `list_my_responses` | builders | Projects you responded to, with status + win/offer flags |
| `list_project_comments` | anyone | List a project's client clarifications |
| `get_response_thread` | builders | Your own response's timeline (comments + versions) |
| `list_conversations` | anyone | Your message inbox (unread counts, last message) |
| `get_conversation` | anyone | One conversation's timeline (in your language) |
| `get_balance` | anyone | **Free** — AI-token balance + access status |
| `list_services` | anyone | **Free** — the shop price list (in ₴) |
| `create_project` | clients | Publish a project brief via a Pro order |
| `create_project_comment` | clients | Add a public clarification to your own project |
| `create_response` | builders | Submit a response (proposal) to a project |
| `post_proposal_update` | builders | Post an updated offer / comment in your thread |
| `create_case` | builders | Publish a portfolio case (draft by default) |
| `generate_case_summary` | builders | Generate a case's AI summary block |
| `update_profile` / `get_profile` | anyone | Edit / read your own public profile |
| `offer_project` / `accept_project` / `decline_project` | client / builder | The offer→accept handshake |
| `send_message` / `mark_conversation_read` | anyone | Message the other party |
| `buy_service` | anyone | **Free tool** — buy an access pass / AI pack / secret mode / case verification (returns a checkout link) |

Every tool enforces the **same rules as the website** — account role, active
access pass, the Super-Expert window, and payment where required. There is no
bypass path; test against a **sandbox** key first.

## Quick start

1. **Create an API key** at [gptaria.com/settings](https://www.gptaria.com/settings)
   → *API keys*. The raw key is shown once — store it as `GPTARIA_API_KEY`.
   - Live keys: `gptaria_live_…`
   - Sandbox keys: `gptaria_sbx_…` — validate every call against the real rules
     but never persist (`{ "dry_run": true }`). Debug safely, then switch to live.
2. **Connect** — pick one:
   - **Hosted connector, no install** (claude.ai / Claude Desktop → *Settings →
     Connectors → Add custom connector*):
     ```
     https://www.gptaria.com/api/mcp?api_key=YOUR_KEY
     ```
   - **Local, via npm** — `npx -y gptaria-mcp` with `GPTARIA_API_KEY` in the
     server's `env` (Claude Code, Cursor, Windsurf).

   See [docs/getting-started.md](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/docs/getting-started.md) for the exact config
   per client, and for the full 23-tool reference.
3. **Install the skills** (optional convenience layer) — copy the folders you
   want from [`skills/`](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/skills) into your assistant's skills directory.

No MCP? Every endpoint is a plain REST call too — see
[docs/api.md](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/docs/api.md) and [examples/curl.md](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/examples/curl.md).

## Install as a Claude Code plugin

In Claude Code, add this repo as a plugin marketplace and install it — the MCP
server (from npm) and the skills come together:

```
/plugin marketplace add gptaria-mcp/gptaria-mcp
/plugin install gptaria-mcp
```

Set `GPTARIA_API_KEY` in your environment first.

## Contents

- [`mcp-server/`](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/mcp-server) — the MCP server (Node, stdio) and its setup
- [`skills/`](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/skills) — three Agent Skills (publish a project, submit a
  response, publish a case)
- [`docs/`](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/docs) — [getting started](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/docs/getting-started.md),
  [REST API reference](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/docs/api.md), [the Pro order flow](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/docs/pro-order.md)
- [`examples/`](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/examples) — MCP client config + curl examples

## Install options

| Channel | How |
| --- | --- |
| **npm** | `npx -y gptaria-mcp` (or `npm i -g gptaria-mcp`) — see [getting started](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/docs/getting-started.md) |
| **Claude Code plugin** | `/plugin marketplace add gptaria-mcp/gptaria-mcp` → `/plugin install gptaria-mcp` |
| **From source** | clone, `cd mcp-server && npm install && node index.mjs` |

Distribution manifests live in the repo: `server.json` (MCP registry),
`.claude-plugin/` (Claude Code), `smithery.yaml` (Smithery).

## Links

- Platform: **https://www.gptaria.com**
- MCP: **https://modelcontextprotocol.io**
- Contributing: [CONTRIBUTING.md](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/CONTRIBUTING.md) · Security: [SECURITY.md](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/SECURITY.md) · [Changelog](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/CHANGELOG.md)

## License

[MIT](https://github.com/gptaria-mcp/gptaria-mcp/blob/HEAD/LICENSE) © GPTaria