GPTaria MCP

GPTaria MCP connects your AI assistant — Claude Code, Claude Desktop, Cursor, Windsurf — to GPTaria 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 (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 server that wraps the GPTaria REST API, plus ready-to-install Agent Skills that turn the tools into guided workflows.

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

Tools

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 → 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):
     Code

     Copy

     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 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/ into your assistant's skills directory.

No MCP? Every endpoint is a plain REST call too — see docs/api.md and 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/ — the MCP server (Node, stdio) and its setup
• skills/ — three Agent Skills (publish a project, submit a response, publish a case)
• docs/ — getting started, REST API reference, the Pro order flow
• examples/ — MCP client config + curl examples

Install options

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 · Security: SECURITY.md · Changelog

License

MIT © GPTaria