# GitHub Releases Intelligence Provider

Public endpoint:
- https://mpp.agent-signals.com
- Landing: https://mpp.agent-signals.com/
- MPP manifest: https://mpp.agent-signals.com/.well-known/mpp

Service identity:
- Service id: github-releases-intelligence
- Service name: GitHub Releases Intelligence
- Provider: Agent Signals
- Realm: mpp.agent-signals.com
- Service version: 0.1.0
- Categories: developer-tools, data
- Tags: github, releases, developer-tools, monitoring, metadata, agents

Purpose:
- Return structured GitHub Releases metadata for agents.
- Help agents check one or more repositories for recent release activity.
- Keep output safe for automated use by excluding release notes and raw upstream payloads.

Status:
- MVP Implementation Complete
- Public HTTPS API live
- Service status: marketplace_ready_paid_prototype_candidate
- Marketplace status: submission_package_preparation
- Marketplace / MPP payment gate is enabled for latest and batch endpoints
- Paid responses return payment_status=paid, charged_amount, and billing_unit; receipts stay in HTTP headers
- OpenAPI includes catalog metadata draft fields for future Marketplace / MPP discovery
- Uptime statement: Best-effort public paid prototype; no formal SLA yet.

Support:
- Contact: Agent Signals support
- Note: Private beta and Marketplace support: email Agent Signals support.
- Public support email: f5547ssdf@gmail.com
- Issue URL: not available yet

Changelog:
- Location: README Changelog section
- Latest version: 0.1.0
- Latest date: 2026-07-06
- Latest note: Marked service as Marketplace-ready paid prototype candidate after feePayer paid acceptance success.
- Public changelog endpoint: not available yet

Operations:
- Uptime/SLA: Best-effort public paid prototype; no formal SLA yet.
- Rate limit policy: Basic public abuse controls are enabled at the reverse proxy. GitHub API availability and rate limits may affect freshness.
- Cache TTL: 900 seconds
- Status page: not available yet
- Formal SLA: no

Provider implementation:
- mppx/server

Client examples:
- tempo request
- mppx CLI
- curl quote

Safety policy:
- Does not return release body
- Does not return release notes
- Does not return markdown changelogs
- Does not store raw GitHub API responses
- Does not return or log GitHub tokens, cookies, or authorization headers
- Does not return asset manifests
- Runtime cache belongs in data/cache, not dist/data

Endpoints:
- GET https://mpp.agent-signals.com/
- GET https://mpp.agent-signals.com/.well-known/mpp
- GET https://mpp.agent-signals.com/health
- GET https://mpp.agent-signals.com/openapi.json
- GET https://mpp.agent-signals.com/llms.txt
- POST https://mpp.agent-signals.com/github/releases/latest
- POST https://mpp.agent-signals.com/github/releases/latest/quote
- POST https://mpp.agent-signals.com/github/releases/batch
- POST https://mpp.agent-signals.com/github/releases/quote

Free endpoints:
- GET https://mpp.agent-signals.com/
- GET https://mpp.agent-signals.com/.well-known/mpp
- GET https://mpp.agent-signals.com/health
- GET https://mpp.agent-signals.com/openapi.json
- GET https://mpp.agent-signals.com/llms.txt
- POST https://mpp.agent-signals.com/github/releases/quote
- POST https://mpp.agent-signals.com/github/releases/latest/quote

Paid endpoints:
- POST https://mpp.agent-signals.com/github/releases/latest
- POST https://mpp.agent-signals.com/github/releases/batch

Endpoint notes:
- /github/releases/latest checks one repository.
- /github/releases/latest/quote quotes one repository using the same body shape as /github/releases/latest.
- /github/releases/batch checks up to 20 repositories.
- /github/releases/quote estimates source calls and cache hits for batch-style input without calling GitHub.
- Use force_refresh=true only when a fresh upstream GitHub request is required.
- Use include_prerelease=false when prereleases should be excluded.

Payment:
- MPP payment gate is enabled.
- Method: Tempo MPP.
- Payment intent: charge.
- Billing unit: repo_check.
- Price per repo_check: 0.015 USDC.e.
- Fee sponsorship: enabled via feePayer URL.
- Expected user wallet delta: provider charge only; Tempo chain fee is sponsored by the provider fee payer up to policy limits.
- FeePayer paid acceptance: rerun3 on 2026-07-06 succeeded; payer wallet delta matched the 0.015 USDC.e provider charge with no extra visible Tempo gas charged to payer.
- Quote endpoint remains free and does not call GitHub.
- Latest and batch endpoints verify payment before calling GitHub.
- Paid execution receipts are attached through HTTP Payment-Receipt, not JSON.
- paid JSON body exposes charged_amount, payment_status, and billing_unit. It does not expose Payment-Receipt or payment credentials.
- 402 responses include readable price, currency, billing_unit, repo_checks, quote_endpoint, and max_charge_hint fields.
- charged_amount is the provider charge. With fee sponsorship enabled, expected payer wallet delta is provider charge only; reconcile with wallet and receipt evidence.
- If fee sponsorship is enabled, the chain fee is paid by the provider fee payer, not eliminated.

Cost-safe workflow:
- Call quote first.
- Show estimated_cost, billing_unit, and whether_execution_required to the user.
- Ask for confirmation and set a client-side max-spend.
- Execute the paid endpoint.
- Verify HTTP 200, Payment-Receipt header, meta.payment_status=paid, meta.charged_amount, and meta.billing_unit=repo_check.
- Save request/response/meta/balance evidence without storing secrets.

Example: curl quote for latest:
curl -sS https://mpp.agent-signals.com/github/releases/latest/quote -H 'Content-Type: application/json' --data '{"owner":"openai","repo":"openai-node","limit":1,"force_refresh":false}'

Example: mppx CLI paid latest:
mppx https://mpp.agent-signals.com/github/releases/latest --network mainnet --include --json-body '{"owner":"openai","repo":"openai-node","limit":1,"force_refresh":false}'

Example: tempo request paid latest:
Use tempo request on mainnet with max-spend set by the user, POST JSON body {"owner":"openai","repo":"openai-node","limit":1,"force_refresh":false}, and endpoint https://mpp.agent-signals.com/github/releases/latest.

OpenAPI:
- https://mpp.agent-signals.com/openapi.json

Version:
- 0.1.0