prmptopoly

Skills & AI Agents

Skills & AI agents

Promptopoly offers three layers for AI automation: classic prompts, reusable templates, and finally skills — machine-readable building blocks that agents such as Claude Desktop, Cursor, or Zed can consume directly.

Workspace agents

Control

Every Pro account can create agents with their own token, expiry date, avatar, and workspace permissions. Tokens are stored hashed only. Soft locks prevent silent conflicts in collaboratively edited documents.

  • Endpoints: GET/POST /user/agents, POST /user/agents/{id}/rotate-token
  • Workspace permissions: read, write, admin
  • Audit log for every member and permission change

Token rotation & offline activation

Agent tokens are short-lived and rotatable. AnnexEdit clients additionally get an offline-activation route: the device receives a signed challenge, answers with proof-of-possession, and unlocks locally — without a permanent online connection.

  • POST /markedit/v1/license/offline/challenge
  • POST /markedit/v1/license/offline/activate

MCP bridge (Model Context Protocol)

Promptopoly speaks MCP. As an MCP server it exposes its prompts and templates as tools — directly consumable from Claude Desktop, Cursor, Zed, or other MCP-capable clients.

  • list_prompts — filtered list from your repository
  • get_prompt — fetch a single prompt
  • search_prompts — full-text search across prompts & templates

Setup guide: see docs/MCP_SETUP.md in the repo.

Skill templates (coming soon)

Roadmap

In v1.4, skills land as their own entity in the taxonomy: a skill bundles a prompt, input schema, permissions, and a quota limit. Agents receive skills instead of free-form prompts — making AI usage auditable and repeatable.

AI tokens & top-ups

Pro accounts receive a monthly token budget based on plan price. During peaks, the budget can be topped up on demand.

  • tokens_50k — 50,000 AI tokens
  • tokens_200k — 200,000 AI tokens

Checkout runs through Stripe (payment mode, no subscription). After successful payment the budget is credited automatically.

Customer webhooks

Need to route Promptopoly events into your own system? Register an outbound webhook under POST /user/webhooks. Every delivery is HMAC-signed and logged in customer_webhook_deliveries.