Perfly Agent connects coding assistants to Perfly, so approved work summaries can be written into your Perfly Today timeline without giving the agent access to your source code, issue bodies, pull requests, documents, or company SaaS accounts.
This repository contains the public agent-facing packages for Perfly Agent Sync:
| Package | Purpose |
|---|---|
mcp/ |
Hosted MCP server metadata, setup instructions, and client examples. |
skill/ |
English canonical Skill instructions for Codex, Claude Code, and compatible coding agents. |
Perfly Agent Sync gives your coding agent a narrow write-only workflow:
- Preview concise work summary items.
- Ask for confirmation unless unattended submission was explicitly enabled.
- Write selected summaries into Perfly as reviewable Today entries.
The MCP server exposes these tools:
| Tool | Purpose |
|---|---|
perfly_check_connection |
Verify the connection and return non-secret token/client metadata. |
perfly_get_ingestion_policy |
Return Perfly privacy and formatting rules. |
perfly_preview_work_items |
Validate items and preview what would be submitted without writing records. |
perfly_add_work_items |
Write selected summaries into Perfly as reviewable Today raw entries. |
Use the hosted MCP endpoint:
https://api.perfly.dev/mcp
Perfly supports MCP OAuth for clients that discover authorization from the server. For clients or environments that cannot complete a browser OAuth flow, Perfly also supports write-only bearer tokens created in the Perfly app.
Start with the MCP package:
Then install or copy the Skill instructions:
Perfly Agent Sync is designed for summary metadata only.
Do not submit:
- source code or diffs
- secrets or credentials
- customer data
- issue bodies or pull request bodies
- document bodies or attachments
- full terminal output or logs
Agents should submit short titles, optional notes, timestamps, source labels, and compact metadata references only.
MCP registries should point to:
mcp/
or:
mcp/manifest.json
Skill hubs should point to:
skill/
or:
skill/SKILL.md
The current ClawHub listing is:
https://clawhub.ai/levi840714/skills/perfly-skill
The current Smithery listings are:
https://smithery.ai/servers/perfly/perfly-mcp
https://smithery.ai/skills/perfly/perfly-skill
- Perfly: https://perfly.dev
- App setup page:
https://app.perfly.dev/agent-setup - MCP endpoint:
https://api.perfly.dev/mcp