{
  "markdown": "# GPTaria MCP\n\n[![npm](https://img.shields.io/npm/v/gptaria-mcp?color=cb3837&logo=npm)](https://www.npmjs.com/package/gptaria-mcp)\n[![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)\n[![MCP](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io)\n[![smithery](https://smithery.ai/badge/git-ttt7/gptaria-mcp)](https://smithery.ai/servers/git-ttt7/gptaria-mcp)\n[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?logo=node.js)](https://nodejs.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md)\n\n**GPTaria MCP** connects your AI assistant — **Claude Code, Claude Desktop,\nCursor, Windsurf** — to [GPTaria](https://www.gptaria.com) and runs the **whole\nflow straight from your editor**: post a project brief, respond with a working\nprototype, message the other party, publish portfolio cases, and buy access —\n**23 tools**. An [MCP](https://modelcontextprotocol.io) (Model Context Protocol)\nserver for the GPTaria REST API.\n\n- **Write in your own language** — content is auto-translated into every platform\n  language (the language is auto-detected from the text).\n- **Prices in UAH (₴)** — you pay by card with a Ukrainian bank card;\n  `list_services` (free) lists exact prices.\n- **Token billing** — most operations spend a little of your AI-token balance;\n  `get_balance` and `list_services` are free. You always confirm any payment.\n\nGPTaria is an informational platform where clients post project briefs and\nbuilders answer with working prototypes. This repo is the **developer surface**:\nan [MCP](https://modelcontextprotocol.io) server that wraps the GPTaria REST API,\nplus ready-to-install [Agent Skills](./skills) that turn the tools into guided\nworkflows.\n\n```\nREST API  →  MCP server  →  Agent skills\n(foundation)  (AI tools)     (guided workflows)\n```\n\n## Tools\n\n| Tool | For | What it does |\n| --- | --- | --- |\n| `list_projects` | anyone | List open projects (briefs) you can respond to |\n| `list_responses` | clients | List a project's responses, to work on them in your own AI |\n| `list_my_responses` | builders | Projects you responded to, with status + win/offer flags |\n| `list_project_comments` | anyone | List a project's client clarifications |\n| `get_response_thread` | builders | Your own response's timeline (comments + versions) |\n| `list_conversations` | anyone | Your message inbox (unread counts, last message) |\n| `get_conversation` | anyone | One conversation's timeline (in your language) |\n| `get_balance` | anyone | **Free** — AI-token balance + access status |\n| `list_services` | anyone | **Free** — the shop price list (in ₴) |\n| `create_project` | clients | Publish a project brief via a Pro order |\n| `create_project_comment` | clients | Add a public clarification to your own project |\n| `create_response` | builders | Submit a response (proposal) to a project |\n| `post_proposal_update` | builders | Post an updated offer / comment in your thread |\n| `create_case` | builders | Publish a portfolio case (draft by default) |\n| `generate_case_summary` | builders | Generate a case's AI summary block |\n| `update_profile` / `get_profile` | anyone | Edit / read your own public profile |\n| `offer_project` / `accept_project` / `decline_project` | client / builder | The offer→accept handshake |\n| `send_message` / `mark_conversation_read` | anyone | Message the other party |\n| `buy_service` | anyone | **Free tool** — buy an access pass / AI pack / secret mode / case verification (returns a checkout link) |\n\nEvery tool enforces the **same rules as the website** — account role, active\naccess pass, the Super-Expert window, and payment where required. There is no\nbypass path; test against a **sandbox** key first.\n\n## Quick start\n\n1. **Create an API key** at [gptaria.com/settings](https://www.gptaria.com/settings)\n   → *API keys*. The raw key is shown once — store it as `GPTARIA_API_KEY`.\n   - Live keys: `gptaria_live_…`\n   - Sandbox keys: `gptaria_sbx_…` — validate every call against the real rules\n     but never persist (`{ \"dry_run\": true }`). Debug safely, then switch to live.\n2. **Connect** — pick one:\n   - **Hosted connector, no install** (claude.ai / Claude Desktop → *Settings →\n     Connectors → Add custom connector*):\n     ```\n     https://www.gptaria.com/api/mcp?api_key=YOUR_KEY\n     ```\n   - **Local, via npm** — `npx -y gptaria-mcp` with `GPTARIA_API_KEY` in the\n     server's `env` (Claude Code, Cursor, Windsurf).\n\n   See [docs/getting-started.md](./docs/getting-started.md) for the exact config\n   per client, and for the full 23-tool reference.\n3. **Install the skills** (optional convenience layer) — copy the folders you\n   want from [`skills/`](./skills) into your assistant's skills directory.\n\nNo MCP? Every endpoint is a plain REST call too — see\n[docs/api.md](./docs/api.md) and [examples/curl.md](./examples/curl.md).\n\n## Install as a Claude Code plugin\n\nIn Claude Code, add this repo as a plugin marketplace and install it — the MCP\nserver (from npm) and the skills come together:\n\n```\n/plugin marketplace add gptaria-mcp/gptaria-mcp\n/plugin install gptaria-mcp\n```\n\nSet `GPTARIA_API_KEY` in your environment first.\n\n## Contents\n\n- [`mcp-server/`](./mcp-server) — the MCP server (Node, stdio) and its setup\n- [`skills/`](./skills) — three Agent Skills (publish a project, submit a\n  response, publish a case)\n- [`docs/`](./docs) — [getting started](./docs/getting-started.md),\n  [REST API reference](./docs/api.md), [the Pro order flow](./docs/pro-order.md)\n- [`examples/`](./examples) — MCP client config + curl examples\n\n## Install options\n\n| Channel | How |\n| --- | --- |\n| **npm** | `npx -y gptaria-mcp` (or `npm i -g gptaria-mcp`) — see [getting started](./docs/getting-started.md) |\n| **Claude Code plugin** | `/plugin marketplace add gptaria-mcp/gptaria-mcp` → `/plugin install gptaria-mcp` |\n| **From source** | clone, `cd mcp-server && npm install && node index.mjs` |\n\nDistribution manifests live in the repo: `server.json` (MCP registry),\n`.claude-plugin/` (Claude Code), `smithery.yaml` (Smithery).\n\n## Links\n\n- Platform: **https://www.gptaria.com**\n- MCP: **https://modelcontextprotocol.io**\n- Contributing: [CONTRIBUTING.md](./CONTRIBUTING.md) · Security: [SECURITY.md](./SECURITY.md) · [Changelog](./CHANGELOG.md)\n\n## License\n\n[MIT](./LICENSE) © GPTaria\n",
  "bytes": 6510,
  "sha": "12df9b49ded0ff636e8138747eb226865e6bf4dce0fcb1ef103c4981626cf326",
  "repo_slug": "gptaria-mcp/gptaria-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gptaria_mcp_gptaria_mcp_c2e73571/readme"
}