MCP Server

Profy provides an MCP (Model Context Protocol) Server that lets you manage the full Expert lifecycle from within Cursor, Codex, or any MCP-compatible IDE — without leaving your editor.

Quick Connection

Create or edit a .mcp.json file in your project root:

{
  "mcpServers": {
    "profy": {
      "url": "https://mcp.profy.cn/mcp"
    }
  }
}

The MCP Server authenticates using your Profy browser session. On first use, your IDE will prompt you to log in to Profy in the browser.

Available Tools (22)

The Profy MCP Server provides 22 tools covering the complete workflow from Expert creation to monetization. All tools are lightweight proxies to existing Profy services and introduce no new business logic.

Identity (2)

Tool	Description	Parameters
`get_creator_profile`	Get your creator profile and status	None
`apply_creator`	Apply to become a Profy marketplace creator	`displayName`, `bio`, `email`, `accountType`

Expert Config (4)

Tool	Description	Parameters
`create_expert`	Create a new Expert draft	`name`, `description?`, `category?`
`update_expert`	Update Expert configuration fields	`identifier`, `name?`, `description?`, `category?`
`get_expert_detail`	Get detailed information about an Expert	`identifier`
`list_my_experts`	List all Experts you created	None

Skills (3)

Tool	Description	Parameters
`install_skill`	Install a marketplace skill for an Expert	`identifier`, `skillName`
`list_expert_skills`	List skills installed on an Expert	`identifier`
`list_marketplace_skills`	Browse the skill marketplace	`keyword?`

Billing & Publish (3)

Tool	Description	Parameters
`set_billing`	Set the Expert’s pricing model and trial configuration	`identifier`, `billingType`, `price?`, `freeTrialPerUser?`, `allowTrial?`
`publish_expert`	Submit an Expert for review and publication	`identifier`
`get_submission_status`	Check the Expert’s review status	`identifier`

Distillation (2)

Tool	Description	Parameters
`start_distillation`	Start a distillation conversation to inject your expertise into an AI Expert	`topic?`, `materials?`
`continue_distillation`	Continue the distillation conversation by answering the AI’s questions	`sessionId`, `message`

Distillation tools use a synchronous SSE collection mode and may take ~30 seconds to complete. Please wait patiently for the response.

Testing (2)

Tool	Description	Parameters
`test_expert`	Send a test message to an Expert and get a reply	`identifier`, `message`
`open_expert_chat`	Get the browser chat page URL for an Expert	`identifier`

Tool	Description	Parameters
`open_profy_page`	Generate a Profy page URL	`page` (studio/chat/marketplace/earnings), `identifier?`

Evolution (3)

Tool	Description	Parameters
`list_evolution_suggestions`	List AI-generated improvement suggestions	`identifier`
`accept_evolution`	Accept an evolution suggestion	`suggestionId`
`get_evolution_stats`	Get evolution statistics for an Expert	`identifier`

Earnings (2)

Tool	Description	Parameters
`get_earnings`	Get the creator’s earnings summary (diamond balance, pending withdrawal, etc.)	None
`browse_marketplace`	Browse published Experts on the marketplace	`keyword?`, `category?`, `page?`, `pageSize?`

Typical Workflows

Creating an Expert from Scratch

You: Use create_expert to create an Expert named "Code Review Assistant"
AI: [Calls create_expert] Created with identifier code-review-helper

You: Start distillation — I'm a code review expert with 10 years of experience
AI: [Calls start_distillation] Distillation started, AI is asking questions...

You: (Answer the AI's questions)
AI: [Calls continue_distillation] Continuing conversation...

You: Set billing to METERED with 5 free trials
AI: [Calls set_billing] Done

You: Publish to the marketplace
AI: [Calls publish_expert] Submitted for review

Reviewing and Optimizing an Expert

You: List all my Experts
AI: [Calls list_my_experts] You have 3 Experts...

You: Check evolution suggestions for code-review-helper
AI: [Calls list_evolution_suggestions] There are 2 suggestions...

You: Accept the first suggestion
AI: [Calls accept_evolution] Accepted; skill updated

You: Check my earnings
AI: [Calls get_earnings] This month's earnings...

Authentication

The MCP Server uses Profy’s Session authentication (Browser Cookie / Bearer Token).

Cursor / Codex IDE plugins: The IDE handles authentication automatically, prompting a browser login on first use
Manual configuration: If your IDE does not handle it automatically, ensure you are logged in at app.profy.cn in your browser

Profy Plugin (IDE Plugin)

Profy provides IDE plugins for Cursor and Codex that include a pre-configured MCP Server and 4 dedicated Skills:

Skill	Description
distillation	Guided distillation workflow
quick-start	Quickly create and configure an Expert
publish-and-earn	Publish to the marketplace and start earning
evolution	View and manage Expert evolution

The plugin’s MCP configuration (.mcp.json) points to mcp.profy.cn/mcp, identical to the manual configuration method.

Transport Protocol

The Profy MCP Server uses Streamable HTTP transport (stateless mode), built on the @modelcontextprotocol/server SDK’s WebStandardStreamableHTTPServerTransport. Key characteristics:

Stateless: No session management; each request is handled independently
CORS: Supports cross-origin requests (with MCP-required headers)
Timeout: 300-second server timeout (to accommodate time-consuming operations like distillation)
Path: All MCP requests are sent to /mcp

Notes

Distillation tools are slow

start_distillation and continue_distillation internally call the invoke endpoint synchronously via the SSE Collector, which may take 20–60 seconds. This is expected — distillation involves multiple rounds of AI interaction.

test_expert is also synchronous

test_expert also waits synchronously for the Expert’s reply via the SSE Collector. Simple conversations typically complete within 5–15 seconds.

Creator status required

Most tools require a logged-in Profy account. Creating and publishing Experts requires first applying for creator status via apply_creator.

All write operations require authentication

Except for browse_marketplace and list_marketplace_skills, all tools require authentication. Calling without being logged in will return an authentication error.

Overview

Platform API

Authentication & Keys

Integrations

SDK

Cookbook

Reference

Quick Connection

Available Tools (22)

Identity (2)

Expert Config (4)

Skills (3)

Billing & Publish (3)

Distillation (2)

Testing (2)

Navigation (1)

Evolution (3)

Earnings (2)

Typical Workflows

Creating an Expert from Scratch

Reviewing and Optimizing an Expert

Authentication

Profy Plugin (IDE Plugin)

Transport Protocol

Notes

Next Steps

Quickstart

App Development Guide

​Quick Connection

​Available Tools (22)

​Identity (2)

​Expert Config (4)

​Skills (3)

​Billing & Publish (3)

​Distillation (2)

​Testing (2)

​Navigation (1)

​Evolution (3)

​Earnings (2)

​Typical Workflows

​Creating an Expert from Scratch

​Reviewing and Optimizing an Expert

​Authentication

​Profy Plugin (IDE Plugin)

​Transport Protocol

​Notes

​Next Steps

Quickstart

App Development Guide

Quick Connection

Available Tools (22)

Identity (2)

Expert Config (4)

Skills (3)

Billing & Publish (3)

Distillation (2)

Testing (2)

Navigation (1)

Evolution (3)

Earnings (2)

Typical Workflows

Creating an Expert from Scratch

Reviewing and Optimizing an Expert

Authentication

Profy Plugin (IDE Plugin)

Transport Protocol

Notes

Next Steps