AI PICKS / CONTRIBUTE

Good tools deserve to be found.

Share your AI tools and Agent Skills. Fill in the details, or let your agent prepare and submit them.

Submit → Editorial review → Listing. A receipt does not mean publication.

01 / WEB

Web submission

Provide clear, accurate details. Up to 20 submissions per user in a rolling 24 hours.

02 / SKILL

Let your agent do the preparation.

The Skill guides preparation: description, category, links and usage examples. With MCP connected, your agent can submit directly.

Download submission Skill

1. Install or place it in your agent’s Skills directory

mkdir -p "$HOME/.codex/skills/aipicks-submit" && curl -fsSL https://aipicks.dev/skills/aipicks-submit/SKILL.md -o "$HOME/.codex/skills/aipicks-submit/SKILL.md"

This command uses the personal Codex Skills directory and replaces an existing file of the same name. Other agents may require a different Skills directory.

2. Tell your agent what you want to share

Use $aipicks-submit to prepare the Skill in this repository. Show me a preview, then submit to AI Picks after my confirmation.

Without MCP, the Skill prepares the details for the web form; it does not claim to submit them.

MCP / DISCOVERY

Let your agent find resources

The public catalog needs no login or credential. It searches and reads resources; it does not submit, install or purchase.

Add this configuration in a client that supports remote HTTP MCP:

{
  "mcpServers": {
    "ai-picks-catalog": {
      "url": "https://aipicks.dev/api/mcp/catalog"
    }
  }
}

search_resources · get_resource

Search AI Picks for frontend design Skills. Explain their uses, installation instructions and sources. Do not automatically install anything.

Public API: /api/resources

03 / MCP

Prepared. Connected. Submitted.

MCP connects your agent to AI Picks. A dedicated credential can only submit resources and read your own receipts, with no account or billing access.

1. Generate a submission credential

Valid for 30 days and displayed only once. Generating a new credential immediately replaces the previous one; update your client configuration.

2. Add to a remote MCP client

Endpoint: https://aipicks.dev/api/mcp

{
  "mcpServers": {
    "ai-picks": {
      "url": "https://aipicks.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SUBMISSION_TOKEN"
      }
    }
  }
}

Replace YOUR_SUBMISSION_TOKEN with your credential. This illustrates connection parameters; follow your client’s configuration format. Streamable HTTP and custom Authorization headers are required. OAuth auto-connect is not available.

Read the official MCP transport guide ↗

3. Submit and verify the receipt

Submit the approved details to AI Picks using submit_resource, then check their status with list_my_submissions.

submit_resource — Submit a tool or Skill for review. Reuse the UUID idempotencyKey when retrying unchanged content.
list_my_submissions — Read your own receipts; paginate using nextCursor.
401: invalid or expired credential. 403: disallowed origin. Web HTTP 429 or MCP tool quota error: rolling daily submission limit reached.