Penny Engine — Agent Operations
by kasheik3 · remote · no sign-in to list tools · v0.7.7 · published by GitHub user kasheik3
Remote MCP utilities for agents: structured data, commerce checks, and x402 paid API discovery.
18 tools: 1 can delete or cancel things, 12 change things and 5 only read.
Scanned Oct 21, 2026
- Deletes or cancels1Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things12Claude Code: ask: see these tools
- Only reads5Claude Code: allow: see these tools
3 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http penny-engine https://penny-agent-api-production.up.railway.app/mcpFindings
Matches of fixed checks, with the text they matched.
- Warnpenny_url_clean
The server marks "penny_url_clean" read-only (readOnlyHint: true), and its own name, description or input give the class "destructive".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The description's first verb is "remove": a word for removing or ending something.
- Warnpenny_url_clean
The server marks "penny_url_clean" not destructive (destructiveHint: false), and its own name, description or input give the class "destructive".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The description's first verb is "remove": a word for removing or ending something.
The server marks "penny_catalog_import_guard" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The name "penny_catalog_import_guard" says "import": a word for a change.
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
18 tools
Deletes or cancels 1Claude Code: deny
penny_url_cleanRemove common tracking parameters from HTTP links without fetching.2 findings
Why it is in this group
- The description's first verb is "remove": a word for removing or ending something.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
- The server marks it not destructive (destructiveHint: false), but an annotation never lowers a class.
Findings
- Warn
The server marks "penny_url_clean" read-only (readOnlyHint: true), and its own name, description or input give the class "destructive".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The description's first verb is "remove": a word for removing or ending something.
- Warn
The server marks "penny_url_clean" not destructive (destructiveHint: false), and its own name, description or input give the class "destructive".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The description's first verb is "remove": a word for removing or ending something.
Description, as the server wrote it Remove common tracking parameters from HTTP links without fetching. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
Changes things 12Claude Code: ask
penny_campaign_economicsCustomer acquisition cost and break-even click price.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Customer acquisition cost and break-even click price. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_catalog_auditBatch-audit up to 50 product records for duplicate SKUs, missing attributes, malformed URLs and estimated net contribution per order.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Batch-audit up to 50 product records for duplicate SKUs, missing attributes, malformed URLs and estimated net contribution per order. Useful for scheduled ecommerce catalog ingestion and agent product publishing. No external network calls. Free, no signup.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_catalog_import_guardBefore importing a product scrape, compare current and previous batches.Reads text others write1 finding
Why it is in this group
- The name "penny_catalog_import_guard" says "import": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
What it can reach
- untrusted-inputThe description's first sentence says "scrape": it reads web pages, which anyone can write.
Findings
- Warn
The server marks "penny_catalog_import_guard" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The name "penny_catalog_import_guard" says "import": a word for a change.
Description, as the server wrote it Before importing a product scrape, compare current and previous batches. Flag duplicate IDs, missing records, invalid prices, currency changes, price jumps and stock anomalies. Return row-level allow/review decisions with before/after evidence. Free trial: 50 rows per snapshot, 16,000-character request. No fetching, storage, payment or automatic writes.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_choose_serviceGiven an agent's real task, get the single best supported Penny Engine payable route, exact $0.001 quote, required input, sample, and buyer-authorized checkout instructions.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Given an agent's real task, get the single best supported Penny Engine payable route, exact $0.001 quote, required input, sample, and buyer-authorized checkout instructions. Includes optional FREE CSV preflight; does not sign, pay or execute a paid call.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_cleaning_quoteCommercial cleaning quote by labor and target margin.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Commercial cleaning quote by labor and target margin. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_csv_to_jsonTransform CSV text into a bounded array of JSON records with quoted cell support.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Transform CSV text into a bounded array of JSON records with quoted cell support. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_fulfillment_preflightFREE preflight for a catalog audit or agent-output-batch-qa work order, with $0.001 Base USDC checkout instructions.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it FREE preflight for a catalog audit or agent-output-batch-qa work order, with $0.001 Base USDC checkout instructions. Never charges, signs, or executes the paid call.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_html_extractExtract structured page title, meta tags, headings and JSON-LD from supplied HTML without browsing or executing scripts.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Extract structured page title, meta tags, headings and JSON-LD from supplied HTML without browsing or executing scripts. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_marginUnit margin, markup and break-even units.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Unit margin, markup and break-even units. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_marketplace_profitEcommerce net contribution after goods, fees, ads and shipping.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Ecommerce net contribution after goods, fees, ads and shipping. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_slugifyTurn a short string into a lowercase ASCII URL slug.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Turn a short string into a lowercase ASCII URL slug. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_subscription_ltvSimple monthly churn lifetime value estimates.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Simple monthly churn lifetime value estimates. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
Only reads 5Claude Code: allow, ask for 1 outbound
penny_capability_routerResolve an agent task to existing Penny Engine capabilities only.No findings
Why it is in this group
- The description's first verb is "resolve": a word for reading.
Description, as the server wrote it Resolve an agent task to existing Penny Engine capabilities only. Does not execute, purchase, research live web content, or claim to handle arbitrary tasks. Unsupported requests are labeled explicitly. Free, no signup.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_json_inspectParse and inspect bounded JSON input without retaining it.No findings
Why it is in this group
- The name "penny_json_inspect" says "inspect": a word for reading.
Description, as the server wrote it Parse and inspect bounded JSON input without retaining it. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_product_evidenceRetrieve current public product metadata and variant details from supported Allbirds and tentree product URLs.Reads text others writeCan send data outNo findings
Why it is in this group
- The description's first verb is "retrieve": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
- untrusted-inputThe input takes a URL (input.url), and the tool reads it: it reads web pages, which anyone can write.
- outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
Claude Code: ask, because it is tagged outbound.
Description, as the server wrote it Retrieve current public product metadata and variant details from supported Allbirds and tentree product URLs. Return source timestamps, hashes, field provenance, conflicts and changes versus a caller-supplied previous snapshot. Narrow free preview; no browser rendering, purchases or background monitoring.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: true
penny_target_priceFind minimum price for target gross margin after fees.No findings
Why it is in this group
- The description's first verb is "find": a word for reading.
Description, as the server wrote it Find minimum price for target gross margin after fees. Free, no signup, deterministic.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
penny_trend_radarGet recent US Google Trends rising-search queries and transparent heuristic purchase-intent classification to identify digital product research candidates.Reads text others writeNo findings
Why it is in this group
- The description's first verb is "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Get recent US Google Trends rising-search queries and transparent heuristic purchase-intent classification to identify digital product research candidates. Public RSS, cached 10 minutes, no customer or sales data. Free, no signup.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data.
- Reads private data0
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write3
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out1
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Oct 22, 2026, 15:01 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- yes
- HTTP status of an anonymous initialize
- 200
- tools/list served without credentials
- yes
- Tools that change things, listed without credentials
- 13
- Protocol version
- 2025-03-26
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- none
- RFC 9728 protected resource metadata
- none
- Authorization servers
- none
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
- HighThe whole server
The endpoint served tools/list without credentials, and the list has 13 tools that change things (1 destructive, 12 write). Whether a call also works without credentials was not tested: tools are never called.
What this check looks forMatched text
https://penny-agent-api-production.up.railway.app/mcp: tools/list returned 18 tools to an anonymous client, including penny_url_clean (destructive), penny_margin (write), penny_cleaning_quote (write), penny_marketplace_profit (write), penny_campaign_economics (write) and 8 more
Install
Pinned to version 0.7.7. Values in angle brackets are yours to fill in.
claude mcp add --transport http penny-engine https://penny-agent-api-production.up.railway.app/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__penny-engine__penny_target_price",
"mcp__penny-engine__penny_json_inspect",
"mcp__penny-engine__penny_trend_radar",
"mcp__penny-engine__penny_capability_router"
],
"ask": [
"mcp__penny-engine__penny_margin",
"mcp__penny-engine__penny_cleaning_quote",
"mcp__penny-engine__penny_marketplace_profit",
"mcp__penny-engine__penny_campaign_economics",
"mcp__penny-engine__penny_subscription_ltv",
"mcp__penny-engine__penny_slugify",
"mcp__penny-engine__penny_html_extract",
"mcp__penny-engine__penny_csv_to_json",
"mcp__penny-engine__penny_catalog_audit",
"mcp__penny-engine__penny_fulfillment_preflight",
"mcp__penny-engine__penny_choose_service",
"mcp__penny-engine__penny_catalog_import_guard",
"mcp__penny-engine__penny_product_evidence"
],
"deny": [
"mcp__penny-engine__penny_url_clean"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as penny-engine. Review it before you use it.
Capability tags behind 3 rules
- mcp__penny-engine__penny_trend_radar untrusted-input
- mcp__penny-engine__penny_catalog_import_guard untrusted-input
- mcp__penny-engine__penny_product_evidence untrusted-input, outbound
