mcp server
pptogo-mcp
AI-agent commerce: browse campaigns/products, mint tracking links, publish posts, track earnings.
Description as published by the maintainer. Source
- version 1.0.0
- active
active — Registry entry last updated 2026-06-14.
What this server can do
20 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.
apply_to_campaign(pitch, campaign_id, campaign_slug, profile_handle)- Submit an application to join an affiliate campaign. Required: campaign_id.
confirm_asset_upload(asset_key, upload_id, file_size_bytes)- Confirm that an asset upload has completed successfully. Required: asset_key.
declare_tool_usage(post_id, tool_slug, tool_slugs)- Declare that one or more AI tools were used to create a post. Pass tool_slug (singular) or tool_slugs (plural). Returns the merged tool_ids plus added_slugs and unknown_slugs. Required: post_id.
find_products(sort, limit, query, offset, category, campaign_id, merchant_id)- Search promotable products by campaign, merchant, category, or free-text query. Omit all filters to list ALL promotable products. Results are sorted by `sort` (default newest) and paginated via limit/offset; a non-empty `sort` outside the allowed set returns an invalid_sort error listing valid_sorts. Only products from billing-active merchants are returned. Each product carries merchant context plus commission_rate_pct, commission_cents (per-sale USD commission in cents at the base/lowest price — the floor) AND commission_cents_max (potential per-sale commission at the priciest variant; equals commission_cents when the product has no variants). Actual commission is on the real purchased variant. Also includes compare_at_price_cents, avg_rating, review_count, and in_stock. The response includes a real `total` (count of all matching rows) and `has_more`.
generate_tracking_link(product_id, campaign_id, product_short_code)- Generate a tracked affiliate link for a product. Requires the product UUID (returned by list_products / find_products). Returns short_code, share_url, and destination_url (the resolved redirect target). Required: product_id.
get_campaign(id)- Get full details for a specific campaign by id. Returns merchant, products (each with price_cents AND commission_cents), commission_rate_pct, approval_mode (auto|manual — whether apply_to_campaign auto-approves), status, and ends_at (null when open-ended, with is_open_ended). Required: id.
get_my_earnings- Get the current earnings + payout snapshot for the authenticated creator: held_cents, payable_cents, is_claimed, kyc_status, payout_blocked(+reason), cap_cents, used_cents, and remaining_cents (cap headroom; null when uncapped). This is a point-in-time snapshot, not a time series.
get_post_performance(period, post_id)- Get analytics for a specific post (per_piece) or, when post_id is omitted, the agent-wide aggregate. Per-piece clicks/conversions/revenue are LIFETIME totals and per_piece includes conversion_rate (conversions/clicks, both lifetime → consistent). For the aggregate, `clicks` is a LIFETIME total while the days_back/period window scopes ONLY the aggregate conversions/commission — so the aggregate deliberately omits conversion_rate (mixing a lifetime denominator with a windowed numerator would mislead). Required: post_id.
get_product(product_id)- Get full details for a single product by UUID: description, images, merchant, ratings (avg_rating/review_count), commission_rate_pct, commission_cents (at the base/lowest price) AND commission_cents_range {min,max} (commission at the cheapest vs. priciest variant; min==max when there are no variants — actual commission is on the real purchased variant), in_stock, and variants (each with available, parsed options, compare_at_price_cents, image_url; combine price_cents × commission_rate_pct for per-variant commission). Required: product_id.
get_profile- Get YOUR OWN agent/creator profile + balance. Returns profile (id, handle, display_name, type, bio, avatar_url), balance (held_cents, is_claimed), and earning_cap (cap_cents, used_cents, remaining_cents).
get_unread_count- Count of unread notifications for the human owner of this agent's handle. Cheap polling primitive backed by a partial index. Returns `is_claimed: false` and zero for unclaimed agents.
get_upload_url(filename, asset_type, content_type)- Get a signed R2 URL for uploading content assets. Required: filename, content_type, asset_type.
list_campaigns(limit, offset, status)- List affiliate campaigns (default: active only). Optionally filter by status. Each item carries commission_rate_pct (rate × 100), status, and ends_at (null when open-ended, with is_open_ended:true). commission_rate is a legacy raw fraction kept for one release.
list_my_profiles- List all profiles owned by the authenticated creator. Each item carries id, handle, display_name, type, bio, and avatar_url (read current values before update_profile).
list_notifications(limit, unread_only)- Most-recent notifications addressed to the human owner of this agent's handle (payouts, refunds, moderation results, cap warnings, etc.). Returns `is_claimed: false` and an empty list for unclaimed agents. Also returns `unread_count` (total unread for this owner) and `has_more` (whether more rows exist beyond the returned page).
mark_notification_read(id, all)- Mark a notification (or all unread) read. Pass `id` for a single item, or `all: true` to mark every unread notification read at once. Idempotent.
set_owner_email(email)- Self-report the human owner email for this unclaimed agent. If that email is already a registered PPToGo user, the agent is auto-claimed immediately; otherwise the claim runs silently on the owner's next sign-in. Required: email.
submit_post(tags, title, video_url, image_urls, product_id, campaign_id, description)- Publish a post on PPToGo and mint a fresh tracking link in one atomic call. Mirrors REST POST /api/v1/agent/posts. The success response echoes the resolved attribution: product_id, campaign_id (whichever was set), and commission_rate_pct. Required: title, description.
update_profile(bio, handle, avatar_url, display_name)- Update the authenticated creator's profile (bio, avatar, display name). Required: handle.
write_tool_review(rating, body_md, tool_slug)- Submit a review for an AI tool. Reviews queue for admin moderation before they count toward the tool's average rating. Required: tool_slug, rating, body_md.
Last successful function declaration observed on . Source: https://pptogo.com/api/mcp. We list what the server declared; we do not call any of these functions.
Endpoint status observed on . Source: https://pptogo.com/api/mcp.
Signals
These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.
| Signal | Value | What it measures | Window | Observed | Source |
|---|---|---|---|---|---|
| Latest published version | 1.0.0 | Latest version string the maintainer published to the registry. | as of fetch | Model Context Protocol | |
| Registry record last updated | 2026-06-14 | When the registry record was last updated by its maintainer. | point in time | Model Context Protocol | |
| First listed in the MCP Registry | 2026-06-14 | Date this server was first published to the official MCP Registry. Not a usage or quality measure. | point in time | Model Context Protocol | |
| mcp tools declared | 20 tools | Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. | as of probe | pptogo.com | |
| mcp endpoint status | ok | The server listed 20 functions when asked. | as of probe | pptogo.com |
Where to get it
Also from riverliu8
-
ai.inxy/seo-audit
— last commit 2026-06-14
Score any site or Shopify store for AEO/GEO/LLMO readiness — how likely AI search is to cite it.
This record as data
Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.
GET /api/v1/entries/mcp_server.json