GPTaria MCP
Post a project brief & publish cases on GPTaria from Claude Code, Cursor or Windsurf.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
gptaria-mcpclaude mcp add gptaria-mcp -e 'GPTARIA_API_KEY=<your gptaria_api_key>' -e 'GPTARIA_BASE_URL=https://www.gptaria.com' -- npx -y gptaria-mcp@0.2.1{
"mcpServers": {
"gptaria-mcp": {
"command": "npx",
"args": [
"-y",
"gptaria-mcp@0.2.1"
],
"env": {
"GPTARIA_API_KEY": "<your gptaria_api_key>",
"GPTARIA_BASE_URL": "https://www.gptaria.com"
}
}
}
}Variables d'environnement
GPTARIA_API_KEYobligatoire secret Your GPTaria API key (Settings → API keys). A gptaria_sbx_… key is safe for testing.GPTARIA_BASE_URLOverride the platform base URL.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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_balanceandlist_servicesare 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
| 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
- 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.
- Live keys:
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-mcpwithGPTARIA_API_KEYin the server'senv(Claude Code, Cursor, Windsurf).
See docs/getting-started.md for the exact config per client, and for the full 23-tool reference.
- Hosted connector, no install (claude.ai / Claude Desktop → Settings →
Connectors → Add custom connector):
- 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-mcpSet GPTARIA_API_KEY in your environment first.
Contents
mcp-server/— the MCP server (Node, stdio) and its setupskills/— three Agent Skills (publish a project, submit a response, publish a case)docs/— getting started, REST API reference, the Pro order flowexamples/— 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
Questions fréquentes
Qu'est-ce que GPTaria MCP ?
Post a project brief & publish cases on GPTaria from Claude Code, Cursor or Windsurf.
Comment installer GPTaria MCP ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add gptaria-mcp -e 'GPTARIA_API_KEY=<your gptaria_api_key>' -e 'GPTARIA_BASE_URL=https://www.gptaria.com' -- npx -y gptaria-mcp@0.2.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour GPTaria MCP ?
Oui. Il attend GPTARIA_API_KEY, à renseigner dans sa configuration.
GPTaria MCP est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient GPTaria MCP ?
Il est publié par gptaria-mcp. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.