GPTaria MCP

GPTaria MCP connects your AI assistant — Claude Code, Claude Desktop, Cursor, Windsurf — to GPTaria: post a project brief, respond with a working prototype, and publish portfolio cases straight from your editor, using the create_project, create_response and create_case tools. An MCP (Model Context Protocol) server for the GPTaria REST API — publish and work on projects without leaving your AI.

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

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
create_project	clients	Publish a project brief via a Pro order (€10)
create_response	builders	Submit a response (proposal) to a project
create_case	builders	Publish a portfolio case (draft by default)
list_project_comments	anyone	List a project's client clarifications
create_project_comment	clients	Add a public clarification to your own project
generate_case_summary	builders	Generate a case's AI summary block from your editor
get_profile / update_profile	anyone	Read / edit your own public profile

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. Run the MCP server and point your assistant at it:

   cd mcp-server
   npm install
   GPTARIA_API_KEY=gptaria_live_xxx node index.mjs
   

   See docs/getting-started.md for the Claude Desktop / Claude Code / Cursor config.
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

Channel	How
npm	npx -y gptaria-mcp (or npm i -g gptaria-mcp) — see getting started
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 · Security: SECURITY.md · Changelog

License

MIT © GPTaria