--- name: gateway.grapevine.fyi description: gateway.grapevine.fyi is a paid IPFS content gateway that retrieves binary files stored at known IPFS CIDs after a small USDC payment on Base. All five skills perform the same core operation — fetch raw binary content by CID — with minor variations in price (0.01–0.07 USDC) and whether the CID is parameterized or hardcoded. No discovery, listing, or metadata capabilities are provided. host: gateway.grapevine.fyi --- # gateway.grapevine.fyi Grapevine operates as a paywalled IPFS gateway on the Base network, serving agents that already know the CID of a file and need to retrieve its raw binary content by paying a per-request USDC fee. It is not a general-purpose IPFS gateway, a search or indexing service, or a content discovery tool. Its distinguishing characteristic is the x402 payment-gated retrieval model, where access to each CID is unlocked by a micropayment. ## When to use this host Use this host when an agent already holds a specific IPFS CID and needs to download its raw binary content, and is prepared to spend 0.01–0.07 USDC per request on Base. Prefer fetch-paid-cid-file or fetch-ipfs-content-by-cid (both 0.01 USDC) for cost efficiency when the CID is parameterized. Use fetch-ipfs-cid-content only if the target is the single hardcoded CID it serves. Do not use this host for: free IPFS access (use a public gateway like ipfs.io or dweb.link instead), CID discovery or directory browsing, ENS/IPNS resolution, structured or text data queries, or bulk/high-frequency downloads where per-request costs accumulate. This host has no unique data or indexing advantage over a standard IPFS gateway except for the x402 payment-gating mechanism itself. ## Capabilities ### Paid CID Retrieval Fetches raw binary content (images, documents, SVGs, and other assets) stored at a known IPFS CID via the Grapevine gateway after paying a per-request USDC fee on Base. The CID must be known in advance; no discovery or listing is supported. - **`fetch-paid-cid-file`** — Fetches a binary file stored at a specific IPFS CID via the Grapevine x402 paywall gateway, returning the raw file content after payment. - **`fetch-ipfs-cid-content`** — Retrieves the content of a specific IPFS CID via the Grapevine gateway after a 0.05 USDC (Base) payment, returning the raw resource payload. - **`fetch-grapevine-cid-content`** — Retrieves the binary content stored at a specific IPFS-style CID via the Grapevine gateway, returning the raw file bytes (e.g. JPEG image) for that content identifier. - **`fetch-ipfs-content-by-cid`** — Retrieves binary content stored at a given IPFS CID via the Grapevine x402 gateway, returning the raw file bytes for 0.01 USDC per request. ## Skill reference ### `fetch-paid-cid-file` **Grapevine Paid CID Gateway** — Fetches a binary file stored at a specific IPFS CID via the Grapevine x402 paywall gateway, returning the raw file content after payment. *Use when:* Use when an agent needs to retrieve a specific file (e.g. SVG, image, or other binary asset) stored at a known IPFS CID on the Grapevine gateway and is prepared to pay 0.01 USDC on Base to access it. *Not for:* Do not use for free or public IPFS content retrieval; use a standard IPFS gateway instead. Not suitable for listing or discovering available CIDs — this endpoint fetches a single known CID only. **Inputs:** - `cid` (string, required) — The IPFS Content Identifier (CID) of the file to fetch, embedded as a path segment in the URL. **Returns:** Returns the raw file content at the requested CID; the observed sample was a 3.2KB SVG-XML image served with content-type image/svg+xml. **Example:** `GET https://gateway.grapevine.fyi/x402/cid/bafkreia6nujebdr2tyzvc4ayvtpi5az5dgrtd3scdvf3ehuepa4b2d3hpa` --- ### `fetch-ipfs-cid-content` **Grapevine Paid CID Fetch** — Retrieves the content of a specific IPFS CID via the Grapevine gateway after a 0.05 USDC (Base) payment, returning the raw resource payload. *Use when:* Use when an agent needs to retrieve the content stored at a specific IPFS CID (bafkreihdwc6aggyoqg2oa5mnwbppiohtc47epwsq7gwhmmln7cqoynxt6m) through the Grapevine gateway and is willing to pay 0.05 USDC on Base per fetch. *Not for:* Do not use for arbitrary IPFS CID lookups — this endpoint is hardcoded to a single CID. Do not use for free IPFS gateway access; this requires a 0.05 USDC payment on Base. **Returns:** Returns the raw text content of the IPFS CID resource — in this case a Stoic philosophy article on the Dichotomy of Control, formatted in Markdown. **Example:** `GET https://gateway.grapevine.fyi/x402/cid/bafkreihdwc6aggyoqg2oa5mnwbppiohtc47epwsq7gwhmmln7cqoynxt6m` --- ### `fetch-grapevine-cid-content` **Grapevine Pay-to-Download (Base USDC)** — Fetches the binary content stored at a specific IPFS CID via the Grapevine gateway after paying 0.07 USDC on Base. *Use when:* Use when an agent needs to retrieve the binary file (e.g. image, document) pinned at a known IPFS CID and is prepared to pay 0.07 USDC on Base per request. *Not for:* Do not use for browsing or discovering CIDs — the CID must be known in advance. Not suitable for free or high-frequency bulk downloads due to per-request payment cost. **Inputs:** - `cid` (string, required) — The IPFS Content Identifier (CID) of the file to fetch, embedded in the URL path. **Returns:** Returns the raw binary file at the given CID; in the sampled case a valid PNG image of approximately 3.12 MB with Content-Type image/png. **Example:** `GET https://gateway.grapevine.fyi/x402/cid/bafybeicamh5d2me7a6czdppp4nikn7o7okfexgaaixubva76uks6pdnkqi` --- ### `fetch-grapevine-cid-content` **Grapevine Paid CID Download** — Retrieves the binary content stored at a specific IPFS-style CID via the Grapevine gateway, returning the raw file bytes (e.g. JPEG image) for that content identifier. *Use when:* Use when an agent needs to download the binary asset associated with a known Grapevine CID and is prepared to pay 0.05 USDC on Base per retrieval. *Not for:* Do not use to search for or discover CIDs — the CID must already be known. Not suitable for text or structured data queries; this returns raw binary content only. **Inputs:** - `cid` (string, required) — The content identifier (CID) embedded in the URL path segment after /x402/cid/. Determines which binary asset is returned. **Returns:** Returns raw binary file content (confirmed JPEG, ~2.22 MB) with Content-Type image/jpeg for the requested CID; no metadata envelope is included. **Example:** `GET https://gateway.grapevine.fyi/x402/cid/bafybeidw3gs4ff5gthqt4kovvtcanae4gqbzmuhrxe6c5jaayoanhdwp6i` --- ### `fetch-ipfs-content-by-cid` **Grapevine CID Gateway** — Retrieves binary content stored at a given IPFS CID via the Grapevine x402 gateway, returning the raw file bytes for 0.01 USDC per request. *Use when:* Use when an agent needs to download the raw binary content of a specific IPFS CID and is prepared to pay 0.01 USDC (Base) per retrieval. *Not for:* Do not use for listing or browsing IPFS directories, resolving ENS/IPNS names, or fetching content without a known CID. Not suitable for free or high-volume bulk downloads. **Inputs:** - `cid` (string, required) — The IPFS Content Identifier (CID) of the resource to retrieve, embedded in the URL path. **Returns:** Returns the raw binary content of the IPFS object at the requested CID; the example response is a PDF file delivered as binary bytes. **Example:** `GET https://gateway.grapevine.fyi/x402/cid/bafkreidgvykqe6qk7hoq2j7p252alsfkphxijhwjsgpt4xjxkeafhsxawi` ---