mcpField
G
GPTaria MCP

GPTaria MCP

Local
github.com/gptaria-mcpBusiness & Marketing0Updated 13w ago
Repository

About GPTaria MCP

GPTaria MCP connects AI assistants to GPTaria for handling project briefs, proposals, messaging, and portfolio cases from an editor. Its 23 tools and optional guided Agent Skills cover the platform’s end-to-end workflows.

Key features

  1. 01Browse projects and responses
  2. 02Create briefs and proposals
  3. 03Manage conversations and offers
  4. 04Publish and summarize portfolio cases
  5. 05Check balance and service prices
  6. 06Optional guided Agent Skills

Use cases

  1. 01Find open briefs to respond to
  2. 02Submit or update a project proposal
  3. 03Message a project client
  4. 04Publish a portfolio case

MCP support

An MCP server wrapping the GPTaria REST API, exposing 23 tools to compatible clients. It can connect through a hosted endpoint or run locally via npm.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "gptaria-mcp-gptaria": {
      "command": "npx",
      "args": [
        "-y",
        "gptaria-mcp"
      ],
      "env": {
        "GPTARIA_API_KEY": "<GPTARIA_API_KEY>",
        "GPTARIA_BASE_URL": "<GPTARIA_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y gptaria-mcp
Environment variables to set
GPTARIA_API_KEYSecretYour GPTaria API key (Settings → API keys). A gptaria_sbx_… key is safe for testing.
GPTARIA_BASE_URLOverride the platform base URL.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmgptaria-mcp0.2.1

Tools

10

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.