Perfly MCP

Created By
17 days ago
Perfly Agent Sync is a hosted MCP server for sending approved coding-agent work summaries into perfly.dev. It is built for narrow, write-only ingestion: agents can preview and submit selected summary items, but they cannot read your Perfly history, reports, profile, billing, integrations, or existing work entries.
Overview

Perfly Agent

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:

PackagePurpose
mcp/Hosted MCP server metadata, setup instructions, and client examples.
skill/English canonical Skill instructions for Codex, Claude Code, and compatible coding agents.

What It Does

Perfly Agent Sync gives your coding agent a narrow write-only workflow:

  1. Preview concise work summary items.
  2. Ask for confirmation unless unattended submission was explicitly enabled.
  3. Write selected summaries into Perfly as reviewable Today entries.

The MCP server exposes these tools:

ToolPurpose
perfly_check_connectionVerify the connection and return non-secret token/client metadata.
perfly_get_ingestion_policyReturn Perfly privacy and formatting rules.
perfly_preview_work_itemsValidate items and preview what would be submitted without writing records.
perfly_add_work_itemsWrite 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:

Privacy Boundary

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.

Packages And Registries

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
Project Info
Created At
17 days ago
Updated At
17 days ago
Author Name
-
Star
-
Language
-
License
-
Category
Tags

Recommend Servers

View All