GPTaria MCP

io.github.gptaria-mcpPublished by GitHub account gptaria-mcpv0.2.1Updated Oct 24, 2026

Post a project brief & publish cases on GPTaria from Claude Code, Cursor or Windsurf.

VerifiedSTDIODesktop onlyProductivity & WorkflowCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Connects an AI assistant to GPTaria, a platform for posting project briefs and publishing prototype-based responses, cases and messages.

What you can do
Browse and read projects, responses, clarifications and response threads, including your own responses and their statuses. Read your message inbox, conversation timelines and your public profile. Publish a project brief, add clarifications, submit or update a response, and run the offer, accept and decline handshake. Publish portfolio cases, generate AI case summaries, and edit your profile. Send messages and mark conversations read. Check your AI-token balance and the price list, and get checkout links for access passes, AI packs, secret mode and case verification.
When to use it
Useful if you work on GPTaria as a client posting briefs or as a builder responding with prototypes, and want to run that flow from Claude Code, Cursor, Windsurf or Claude Desktop instead of the website. Test with a sandbox key before going live.
Requirements
Runs locally over stdio via npm (npx gptaria-mcp) or as a Claude Code plugin; a hosted connector option is also described. Requires a GPTaria account and an API key in GPTARIA_API_KEY, created in account settings. GPTARIA_BASE_URL can override the platform base URL. Network access to GPTaria is needed.
Before you install
The API key is a secret shown once; store it only in GPTARIA_API_KEY and prefer a sandbox key for testing. Many tools write or send data: publishing briefs, responses, comments, cases, profile edits and messages. Most operations spend AI-token balance, and buying services returns a checkout link for card payment in UAH; payments are confirmed by you. Account role and access rules apply as on the website.

Installation

In SourceWeft

  1. Open GPTaria MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

GPTaria MCP

[npm] [CI] [MCP] [smithery] [Node] [License: MIT] [PRs Welcome]

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

ToolForWhat it does
list_projectsanyoneList open projects (briefs) you can respond to
list_responsesclientsList a project's responses, to work on them in your own AI
list_my_responsesbuildersProjects you responded to, with status + win/offer flags
list_project_commentsanyoneList a project's client clarifications
get_response_threadbuildersYour own response's timeline (comments + versions)
list_conversationsanyoneYour message inbox (unread counts, last message)
get_conversationanyoneOne conversation's timeline (in your language)
get_balanceanyoneFree — AI-token balance + access status
list_servicesanyoneFree — the shop price list (in ₴)
create_projectclientsPublish a project brief via a Pro order
create_project_commentclientsAdd a public clarification to your own project
create_responsebuildersSubmit a response (proposal) to a project
post_proposal_updatebuildersPost an updated offer / comment in your thread
create_casebuildersPublish a portfolio case (draft by default)
generate_case_summarybuildersGenerate a case's AI summary block
update_profile / get_profileanyoneEdit / read your own public profile
offer_project / accept_project / decline_projectclient / builderThe offer→accept handshake
send_message / mark_conversation_readanyoneMessage the other party
buy_serviceanyoneFree 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

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

Install options

ChannelHow
npmnpx -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 sourceclone, 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

Source: README.md at commit 5f50ada

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts