Skip to content
Back to search

purrkey

MarketplaceWorks with Claude CodeGitHub

Official Purrkey plugins: pay-per-call data tools for AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/purrkey--plugins/badge.svg)](/listings/purrkey--plugins)

HTML

<a href="/listings/purrkey--plugins"><img src="/api/listings/purrkey--plugins/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

/plugin marketplace add purrkey/plugins
/plugin install purrkey@purrkey

Or from a terminal:

claude plugin marketplace add purrkey/plugins
claude plugin install purrkey@purrkey

Restart Claude Code with `PURRKEY_API_KEY` set, then check the connection with `/mcp`.

Cursor

Install from this repository with `npx plugins add purrkey/plugins`, or add the MCP server by hand to `~/.cursor/mcp.json`:

{
  "mcpServers": {
    "purrkey": {
      "url": "https://api.purrkey.app/mcp",
      "headers": { "Authorization": "Bearer ${env:PURRKEY_API_KEY}" }
    }
  }
}

Restart Cursor after changing its environment, then check the connection under **Settings → Tools & MCP**.

Codex

codex mcp add purrkey --url https://api.purrkey.app/mcp --bearer-token-env-var PURRKEY_API_KEY

To give Codex the skill too, copy `plugins/purrkey/skills/purrkey/` to `${CODEX_HOME:-$HOME/.codex}/skills/purrkey/`.

Any other MCP client

Add a remote (streamable HTTP) MCP server:

- URL: `https://api.purrkey.app/mcp` - Header: `Authorization: Bearer <your Purrkey API key>`

Setup for more clients is in the [MCP quickstart](https://purrkey.app/docs/quickstart/mcp?utm_source=github&utm_medium=readme&utm_campaign=geo_launch).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 35 lines
  1. {
  2. "name": "purrkey",
  3. "owner": {
  4. "name": "Purrkey",
  5. "email": "support@purrkey.app",
  6. "url": "https://purrkey.app"
  7. },
  8. "description": "Official Purrkey plugins: pay-per-call data tools for AI agents.",
  9. "plugins": [
  10. {
  11. "name": "purrkey",
  12. "source": "./plugins/purrkey",
  13. "category": "data",
  14. "version": "0.1.1",
  15. "description": "Find, price and run 1,100+ data tools from your agent: social media, e-commerce, travel, jobs, web search and scraping. Pay per call from one Purrkey balance.",
  16. "author": {
  17. "name": "Purrkey",
  18. "url": "https://purrkey.app"
  19. },
  20. "homepage": "https://purrkey.app",
  21. "repository": "https://github.com/purrkey/plugins",
  22. "license": "MIT",
  23. "keywords": [
  24. "purrkey",
  25. "mcp",
  26. "ai-agents",
  27. "data",
  28. "scraping",
  29. "social-media",
  30. "search",
  31. "api"
  32. ]
  33. }
  34. ]
  35. }
README.md · README · 114 lines
  1. <p align="center">
  2. <a href="https://purrkey.app/?utm_source=github&utm_medium=readme&utm_campaign=geo_launch"><img src="plugins/purrkey/assets/icon.png" alt="Purrkey" width="96"></a>
  3. </p>
  4. <h1 align="center">Purrkey plugins</h1>
  5. <p align="center">
  6. <a href="https://purrkey.app/?utm_source=github&utm_medium=readme&utm_campaign=geo_launch">purrkey.app</a> ·
  7. <a href="https://purrkey.app/docs/quickstart/mcp?utm_source=github&utm_medium=readme&utm_campaign=geo_launch">Docs</a> ·
  8. <a href="https://purrkey.app/tools?utm_source=github&utm_medium=readme&utm_campaign=geo_launch">Tool catalog</a> ·
  9. <a href="https://github.com/purrkey-ai/cli">CLI</a>
  10. </p>
  11. Official agent plugins for [Purrkey](https://purrkey.app/?utm_source=github&utm_medium=readme&utm_campaign=geo_launch), a pay-per-call tool marketplace for AI agents. Your agent finds the right tool for each task, sees the price and runs it with one key, no sign-ups.
  12. The catalog lists over 1,100 endpoints: social data from TikTok, Instagram, YouTube, Reddit, X, Facebook and LinkedIn, plus Douyin, Xiaohongshu, Weibo and Bilibili; product, review and travel data from Amazon, eBay, Airbnb and Booking; and web search, scraping and crawling.
  13. Each plugin adds two things:
  14. | File | What it does |
  15. | --- | --- |
  16. | `plugins/purrkey/.mcp.json` (Claude Code), `plugins/purrkey/mcp.json` (Cursor) | Connects the hosted Purrkey MCP server at `https://api.purrkey.app/mcp` |
  17. | `plugins/purrkey/skills/purrkey/SKILL.md` | Teaches the agent to discover a tool, inspect its schema and price, run it within a spending cap and recover the original Run instead of paying twice |
  18. There is no executable code and no install script.
  19. ## Before you install
  20. 1. Create an API key at [purrkey.app/keys](https://purrkey.app/keys?utm_source=github&utm_medium=readme&utm_campaign=geo_launch). New accounts get $1 in free credit and there is no subscription.
  21. 2. Make the key available to your agent client as `PURRKEY_API_KEY`, through your shell profile or a secret manager. Keep it out of chat and project files.
  22. ## Install
  23. ### Claude Code
  24. ```
  25. /plugin marketplace add purrkey/plugins
  26. /plugin install purrkey@purrkey
  27. ```
  28. Or from a terminal:
  29. ```sh
  30. claude plugin marketplace add purrkey/plugins
  31. claude plugin install purrkey@purrkey
  32. ```
  33. Restart Claude Code with `PURRKEY_API_KEY` set, then check the connection with `/mcp`.
  34. ### Cursor
  35. Install from this repository with `npx plugins add purrkey/plugins`, or add the MCP server by hand to `~/.cursor/mcp.json`:
  36. ```json
  37. {
  38. "mcpServers": {
  39. "purrkey": {
  40. "url": "https://api.purrkey.app/mcp",
  41. "headers": { "Authorization": "Bearer ${env:PURRKEY_API_KEY}" }
  42. }
  43. }
  44. }
  45. ```
  46. Restart Cursor after changing its environment, then check the connection under **Settings → Tools & MCP**.
  47. ### Codex
  48. ```sh
  49. codex mcp add purrkey --url https://api.purrkey.app/mcp --bearer-token-env-var PURRKEY_API_KEY
  50. ```
  51. To give Codex the skill too, copy `plugins/purrkey/skills/purrkey/` to `${CODEX_HOME:-$HOME/.codex}/skills/purrkey/`.
  52. ### Any other MCP client
  53. Add a remote (streamable HTTP) MCP server:
  54. - URL: `https://api.purrkey.app/mcp`
  55. - Header: `Authorization: Bearer <your Purrkey API key>`
  56. Setup for more clients is in the [MCP quickstart](https://purrkey.app/docs/quickstart/mcp?utm_source=github&utm_medium=readme&utm_campaign=geo_launch).
  57. ## Try it
  58. Ask your agent something that needs live data, for example:
  59. > Find the 10 most recent Xiaohongshu notes about "matcha latte" and summarize what people complain about.
  60. The agent will `discover` candidate tools, `inspect` the one that fits, run it and report what it cost.
  61. ## Disclosure
  62. Purrkey ([purrkey.app](https://purrkey.app)) is a **paid third-party service**. Before installing, know that:
  63. - **Network calls.** Your agent sends tool requests to Purrkey (`api.purrkey.app`), which forwards them to the data provider that runs the tool.
  64. - **Money.** Running a tool spends your prepaid Purrkey balance. `discover` and `inspect` are free. The skill treats your request as permission for the ordinary calls it needs, so it does not ask before each one. Every Run carries a maximum charge derived from the published price, and you can set account-wide daily and per-run caps at [purrkey.app/budget](https://purrkey.app/budget). Retrying a lost request with the same idempotency key returns the original Run and is not charged again.
  65. - **Credentials.** The plugin reads your key from the `PURRKEY_API_KEY` environment variable. It never stores the key and the skill never asks you to paste it into chat.
  66. - **No telemetry, hooks or background processes** are added by this plugin. It registers one MCP server and one skill.
  67. ## Development
  68. ```sh
  69. node scripts/check.mjs # versions and MCP URLs agree across manifests
  70. claude plugin validate . # Claude Code marketplace and plugin
  71. ```
  72. When `SKILL.md` or an MCP config changes, bump the version in every manifest (`scripts/check.mjs` lists them). Claude Code and Cursor only deliver updates when the version changes.
  73. Issues and pull requests are welcome. For account or billing questions, email [support@purrkey.app](mailto:support@purrkey.app).
  74. ## License
  75. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.