get_balance
Get credit balance
Shows account plan, masked email, balance and daily allowance.
Takes no parameters.
io.pugiPublished by pugi.ioOfficial publisherv1.0.0Updated Nov 7, 2026
AI product team: builds and publishes websites from a brief, logos, security checks.
Pugi is a remote AI product-team service that lets an assistant build, security-check, preview and publish websites and apps from a brief, plus make logos.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.pugi%2Fpugi/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"pugi": {
"type": "http",
"url": "https://api.pugi.io/api/agent/v1/mcp"
}
}
}[Pugi skills for your coding agent]
Let your coding agent brief Pugi to build, design, secure and publish your app.
[Release] [License: MIT] [11 skills] [Works with Claude Code] [Works with Codex] [Works with Cursor]
pugi.io | Docs | Support | Pricing
Pugi is the AI product team that turns a plain brief into a live, tested app. These are Agent Skills for it. Install them in Claude Code, Codex, Cursor or any agent that reads the Agent Skills format, and your agent can brief Pugi to build and deliver an app, design it, start from a template, make a brand and a site in it, check and fix security, and publish.
Inside a session the same commands are /plugin marketplace add pugi-io/skills and /plugin install pugi@pugi. The skills then run as /pugi:<skill> (for example /pugi:pugi-publish), and Claude Code also picks them up on its own when a task matches.
Without the plugin, copy the skill folders into your skills directory:
Codex reads skills from .agents/skills/ in the repository (from the working directory up to the repository root) and from ~/.agents/skills/ for your user. To install one skill with the built-in installer:
The repository is also a plugin in the open Agent Plugins format (plugin.json at the root, with Codex settings under extensions.com.openai), with .codex-plugin/plugin.json kept as a fallback and a marketplace file at .agents/plugins/marketplace.json:
Restart Codex so it picks up new skills. Each skill has an agents/openai.yaml with its display name and default prompt.
Cursor loads Agent Skills from .cursor/skills/ and .agents/skills/ in a project, and from ~/.cursor/skills/ and ~/.agents/skills/ for your user. It also reads .claude/skills/ and .codex/skills/.
The repository is also laid out as a single Cursor plugin, following https://github.com/cursor/plugin-template: .cursor-plugin/plugin.json at the root with name, description, version and author, and the skills in skills/. It is not in the Cursor Marketplace yet.
Each skill is a folder with a SKILL.md (YAML front matter plus Markdown) and optional scripts/. Copy skills/<name>/ to wherever your agent loads skills from.
Which one to use: pugi-build starts a run; pugi-sdlc takes a run through its gates to going live; pugi-publish and pugi-deploy-repo put code you already have online. Plans and limits: pugi.io/pricing.
Each skill has a status table that marks every step as Available, Not available today or Coming soon. The skills use only what is live: the pugi CLI (@pugi/cli 1.0.0-alpha.246 or later, the version the commands were tested against) and pugi.io pages. More agent tools are coming; the skills tell the agent to use them only once they appear in its tool list or in https://pugi.io/llms.txt.
Pugi also runs a remote MCP server for agents. It is listed in the official MCP Registry as io.pugi/pugi; its entry is server.json.
https://api.pugi.io/api/agent/v1/mcp (Streamable HTTP)Authorization: Bearer pugi_agent_.... Create a key with POST https://api.pugi.io/api/agent/v1/keys.scan_url (passive, read-only security check of a public website, graded A+ to F), get_balance, buy_credits_link (a card checkout link a person opens; it never charges by itself), publish_status.Details, prices and limits: pugi.io/agents.md.
pugi publish.pugi scaffold writes only missing files and lists the ones it skipped. The skill uses --force, which overwrites, only when you ask for it.scripts/check-domain.sh only reads what DNS and HTTPS say.allow_implicit_invocation: false, so they run only when you call them, for example $pugi-publish. Only pugi-security-check and pugi-logo may start on their own.pugi publish prints only the names of env keys, and pugi-security-check reports the file and the type of a key, never its value.pugi-build, pugi-sdlc, pugi-artifacts, pugi-publish, pugi-deploy-repo): Node.js 18+, git, and a Pugi account. Install the CLI with npm i -g @pugi/cli and sign in with pugi login. The sign-in is a device flow: you approve it in your browser.pugi-security-check: Python 3.8+ and git. The script uploads nothing; the optional MCP tool scan_url sends the URL to Pugi.pugi-design, pugi-start-from-template, pugi-brand-to-site, pugi-fix-security, pugi-logo): a browser. pugi-design needs the Founder plan or higher.The skills format is the same for every agent: one SKILL.md per folder. Only the plugin manifests differ, so each agent gets its own manifest next to the shared skills/ folder.
Bug reports and skill requests are welcome in Issues. Before a pull request, run bash scripts/check.sh. See CONTRIBUTING.md.
Report a vulnerability to [email protected], not in a public issue. See SECURITY.md.
Questions about your account, plan or a build: pugi.io/support or [email protected]. Developer docs: docs.pugi.dev.
The skills, scripts and documentation are under the MIT License. See LICENSE. Each skill folder carries its own copy as LICENSE.txt, so a skill copied on its own keeps the notice.
The images in assets/ (icon.png, banner.png and social-preview.png) show the Pugi logo and are not under the MIT License. They are included only so that plugin directories and this page can show Pugi's mark, and you may redistribute them unchanged as part of this repository for that purpose. "Pugi" and the Pugi logo are trademarks of Pugi Inc.; the license gives no right to use them otherwise. See assets/NOTICE.
Source: README.md at commit d65569f
Get credit balance
Shows account plan, masked email, balance and daily allowance.
Takes no parameters.
Get a link to add credit
Get a link to add credit.
amount_usdCheck a website for security issues
Checks a public website for HTTPS, security headers and exposed secrets.
urlrequiredMake four logos
Creates four logos from the business name, description and style words. Pass the user's description and style words verbatim. Pugi first asks a few brief questions, one per call (needs_input, free), in the language you pass as language: ask the user exactly that question, then call again with trade or answers so far; draw_now true draws from what is known. Generates logo design assets only.
namenichestyletradestylesanswerscolourspaletterefinestaglinedraw_nowindustry+5 moreGet publish status
Get publish status.
project_idSearch the Pugi catalogue
Search the Pugi catalogue.
tagslimitquerycategoryCheck a GitHub repository for security issues
Checks a public GitHub repository for leaked secrets, vulnerable dependencies and risky code.
refrepo_urlrequiredidempotency_keyrequiredBuild a web app
Builds a web app from a brief, like build_site builds a website. Pass the brief in the customer's own words. Progress shows in the build card. Pugi checks the built app for security issues; publish waits for that check.
pickbriefrequiredthemelocalelogo_idmax_usdsite_languagebrandHandoffIdidempotency_keyrequiredBuild a website from a brief
Builds a website from a brief and returns a job_id. Pass the customer's brief in the customer's own words; do not add features the customer did not ask for (no invented sign-up, accounts, subscriptions or payments). A build takes several minutes; the call may return while it is still running. In hosts that render the build card (MCP Apps or ChatGPT widget), the card tracks progress automatically: do not poll job_status. In hosts without a build card (Claude Code or API), call job_status with the job_id until the job is finished, stopped or failed. Review the view-only preview_url before publishing. One build at a time per account.
pickbriefrequiredthemelocalelogo_idmax_usdsite_languagebrandHandoffIdidempotency_keyrequiredChange a site Pugi built
Changes a website in its existing project. Progress shows in the build card.
pickthemejob_idlocalelogo_idmax_usdproject_idinstructionrequiredsite_languagebrandHandoffIdidempotency_keyrequiredGet the status of a build
Returns the state of a build or edit job (running, finished, stopped or failed), a short progress line and, when available, a view-only preview_url. In hosts that render the build card (MCP Apps or ChatGPT widget), the card tracks progress automatically: do not poll job_status. In hosts without a build card (Claude Code or API), call job_status with the job_id until the job is finished, stopped or failed. Preview links expire after 15 minutes; call again for a fresh link.
job_idrequiredPublish a built site
Publishes a built website at its public address.
job_idproject_ididempotency_keySelect a logo
Returns the chosen account-owned logo ID. Does not buy or generate anything.
logo_idrequired100% 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.
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.
claude plugin marketplace add pugi-io/skillsclaude plugin install pugi@pugigit clone https://github.com/pugi-io/skills pugi-skillsmkdir -p ~/.claude/skillscp -r pugi-skills/skills/* ~/.claude/skills/ # or .claude/skills/ in a projectgit clone https://github.com/pugi-io/skills pugi-skillsmkdir -p ~/.agents/skills && cp -r pugi-skills/skills/* ~/.agents/skills/$skill-installer install https://github.com/pugi-io/skills/tree/main/skills/pugi-publishcodex plugin marketplace add pugi-io/skillsgit clone https://github.com/pugi-io/skills pugi-skillsmkdir -p ~/.cursor/skills && cp -r pugi-skills/skills/* ~/.cursor/skills/.├── .claude-plugin/│ ├── plugin.json Claude Code plugin manifest│ └── marketplace.json Claude Code marketplace (one plugin: this repo)├── plugin.json Agent Plugins manifest (Codex reads extensions.com.openai)├── .codex-plugin/plugin.json Codex fallback manifest├── .agents/plugins/marketplace.json├── .cursor-plugin/plugin.json├── server.json MCP Registry entry for the Pugi MCP server (io.pugi/pugi)├── smithery/ Smithery listing text and config schema├── assets/ icon, banner, social preview, NOTICE├── skills/ one folder per skill: SKILL.md, agents/openai.yaml, optional scripts/│ ├── pugi-build/ pugi-sdlc/ pugi-artifacts/ pugi-design/│ ├── pugi-start-from-template/ pugi-logo/ pugi-brand-to-site/│ ├── pugi-security-check/ scripts/precheck.py│ ├── pugi-fix-security/ pugi-deploy-repo/│ └── pugi-publish/ scripts/check-domain.sh└── scripts/check.sh Validates front matter and scans this repo for secrets