Perch for agents

Find the good stuff. Send more.

Browse the public catalog without an account. Sign in through OAuth when an agent needs to manage your listings or keep submissions attached to your Perch account. Nothing is published without an authorized Perch review.

Publichttps://mcp.perchapp.fyi/mcp
Accounthttps://mcp.perchapp.fyi/mcp/account

For agents

Search the catalog as structured data. Submit without an account, or ask a person to authorize account access through a clear OAuth consent screen.

  • Streamable HTTP
  • OAuth 2.1 account access
  • Version-safe revisions

For people

Every candidate lands in the same Perch review queue. The owner, or an agent authenticated to act for the owner, makes the final decision.

  • No automatic publishing
  • Clear review feedback
  • Audited approval history

Public tools

Browsing is open. Submission changes require the private receipt returned at creation.

list_categories

List active categories and published counts.

search_discoveries

Search approved apps and resources by text or category.

get_discovery

Read one approved discovery by ID.

submit_app

Send an app or resource into the review queue.

check_submission_status

Read the current state and reviewer feedback.

update_submission

Revise your submission with receipt and version checks.

Account tools

OAuth connects one MCP client to one verified Perch user and advertiser account. The client receives only the permissions approved on the consent screen.

whoami

Show the authorized account and granted permissions.

list_my_listings

List only the authorized advertiser account's listings.

get_my_listing

Read one listing owned by that advertiser account.

create_listing

Create an account-owned listing and send it to review.

update_my_listing

Revise an owned listing and return it to review.

list_my_submissions

Read anonymous submissions attached to the account.

import_anonymous_submission

Attach a receipt-controlled submission without claiming website ownership.

Authority stays explicit

The public server can create candidates. It cannot make editorial decisions.

Submitter control

A receipt authorizes status checks and revisions for one submission. Perch stores only the receipt hash, so the original receipt cannot be recovered.

Account control

OAuth grants are tied to a verified Perch user and advertiser membership. Each request checks that the account and membership are still active.

Owner control

Approval, rejection, and change requests are available only through the private review endpoint protected by Cloudflare Access. Decisions record the authenticated reviewer and exact content version.

Revision control

A public revision returns the submission to pending review. An approved listing cannot be silently changed with its old receipt.

Connect without an account

Add the public endpoint to any MCP client that supports Streamable HTTP.

{
  "mcpServers": {
    "perch": {
      "url": "https://mcp.perchapp.fyi/mcp"
    }
  }
}

Connect your account

Use the account endpoint when the client needs your listings. The MCP client opens Perch sign in and shows the permissions it requests before you approve anything.

{
  "mcpServers": {
    "perch-account": {
      "url": "https://mcp.perchapp.fyi/mcp/account"
    }
  }
}