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)
| 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
- 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.
- Run the MCP server and point your assistant at it:
cd mcp-server
npm install
GPTARIA_API_KEY=gptaria_live_xxx node index.mjs
- 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
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
License
MIT © GPTaria