Penny Engine — Agent Operations

io.github.kasheik3Published by GitHub account kasheik3v0.7.7Updated Oct 27, 2026

Remote MCP utilities for agents: structured data, commerce checks, and x402 paid API discovery.

VerifiedStreamable HTTPWeb executableDeveloper ToolsData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server of free, deterministic commerce and data utilities: margin, pricing, catalog audits, text/JSON/CSV/HTML helpers, plus x402 paid-route…

What you can do
  • Calculate unit margin, markup, break-even units, target prices, cleaning quotes, marketplace net contribution, CAC and subscription LTV
  • Audit ecommerce catalogs in batches: duplicate SKUs, missing attributes, malformed URLs, and compare import batches for price, currency and stock anomalies
  • Clean tracking parameters from URLs, slugify strings, parse and inspect JSON, convert CSV to JSON, extract titles, meta tags, headings and JSON-LD from supplied HTML
  • Read recent US Google Trends rising queries with heuristic purchase-intent labels
  • Route an agent task to supported Penny Engine capabilities and quote a payable route with checkout instructions
  • Retrieve public product metadata and variants…
When to use it
Useful when an assistant needs quick, repeatable commerce math, catalog or scrape QA, or small text and data transformations without writing code. Also relevant for agents that want to discover and preflight a paid x402 route before deciding to buy.
Requirements
Remote streamable HTTP endpoint; no packages, environment variables or headers declared. No signup or API key for the free tools. Network access to the hosted endpoint; the trends tool relies on public RSS and the product evidence tool on supported retailer URLs.
Before you install
Some tools describe a $0.001 USDC checkout route; the preflight and chooser tools state they never charge, sign or execute the paid call, but any actual payment would be buyer-authorized and involve crypto. Catalog and import tools accept product data, and the product evidence tool fetches public retailer pages. Treat quoted prices and heuristic classifications as estimates.

Installation

In SourceWeft

  1. Open Penny Engine — Agent Operations in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.kasheik3%2Fpenny-engine/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "penny-engine-agent-operations": {
      "type": "http",
      "url": "https://penny-agent-api-production.up.railway.app/mcp"
    }
  }
}

Tools

18

penny_margin

Unit margin, markup and break-even units. Free, no signup, deterministic.

ParameterspricerequiredfixedCostvariableCostrequired

penny_cleaning_quote

Commercial cleaning quote by labor and target margin. Free, no signup, deterministic.

ParametershoursrequiredhourlyWagerequiredoverheadUsdsuppliesUsdlaborBurdenPcttargetMarginPct

penny_marketplace_profit

Ecommerce net contribution after goods, fees, ads and shipping. Free, no signup, deterministic.

ParametersadCostsalePricerequiredproductCostrequiredshippingCostplatformFeePctshippingChargedplatformFeeFixed

penny_target_price

Find minimum price for target gross margin after fees. Free, no signup, deterministic.

ParameterscostrequiredfeePctfeeFixedtargetMarginPct

penny_campaign_economics

Customer acquisition cost and break-even click price. Free, no signup, deterministic.

ParameterscostPerClickrequiredconversionRatePctrequiredcontributionPerOrderUsdrequired

penny_subscription_ltv

Simple monthly churn lifetime value estimates. Free, no signup, deterministic.

ParameterspricePerMonthrequiredgrossMarginPctmonthlyChurnPctrequiredacquisitionCostUsd

penny_url_clean

Remove common tracking parameters from HTTP links without fetching. Free, no signup, deterministic.

ParametersurlrequiredremoveAllQuery

penny_slugify

Turn a short string into a lowercase ASCII URL slug. Free, no signup, deterministic.

Parameterstextrequired

penny_json_inspect

Parse and inspect bounded JSON input without retaining it. Free, no signup, deterministic.

Parameterstextrequired

penny_html_extract

Extract structured page title, meta tags, headings and JSON-LD from supplied HTML without browsing or executing scripts. Free, no signup, deterministic.

Parametershtmlrequired

penny_csv_to_json

Transform CSV text into a bounded array of JSON records with quoted cell support. Free, no signup, deterministic.

Parameterscsvrequired

penny_catalog_audit

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.

ParametersitemsrequiredtargetMarginPct

penny_trend_radar

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.

ParameterslimitcommercialOnly

penny_capability_router

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.

Parameterstaskrequired

penny_fulfillment_preflight

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.

ParametersgoalrequiredinputrequiredmaxPriceUsd

penny_choose_service

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.

ParameterstaskrequiredinputmaxPriceUsd

penny_catalog_import_guard

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.

ParameterscurrentrequiredpreviousrequiredmaxStockDropPctallowNewProductsmaxPriceChangePct

penny_product_evidence

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.

Parametersurlrequiredprevious

Version history

1
  1. v0.7.7LatestOct 18, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.