GPTaria MCP
Post a project brief & publish cases on GPTaria from Claude Code, Cursor or Windsurf.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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"
}
}
}
}متغيرات البيئة
GPTARIA_API_KEYإلزامي سري Your GPTaria API key (Settings → API keys). A gptaria_sbx_… key is safe for testing.GPTARIA_BASE_URLOverride the platform base URL.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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
الأسئلة الشائعة
ما هو GPTaria MCP؟
Post a project brief & publish cases on GPTaria from Claude Code, Cursor or Windsurf.
كيف أثبّت GPTaria MCP؟
يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج GPTaria MCP إلى مفتاح API؟
نعم. يتطلب GPTARIA_API_KEY، وتضبطها في إعداداته.
هل GPTaria MCP مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون GPTaria MCP؟
ينشره gptaria-mcp. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.