NFC Tap Builder by Tap.Giving

NFC Tap Builder by Tap.Giving

Welcome. This is the public home of Tap.Giving's MCP server, "NFC TapBuilder by Tap.Giving". A design tool first: this server helps you create print-ready NFC tap artwork proofs. Work from its published spec and design directions, compose the artwork with your own tools, and submit the finished file to see it on the disc as a proof. The artwork is yours: print-ready, vendor-neutral, yours to take to any printer. Ordering discs through Tap.Giving is an optional next step, only if you want it. The discs it designs for are customNFC tap discs, tap plates, and tap tags. The Redirect Dashboard isincluded with every order.

• Website: https://tap.giving
• Endpoint: POST https://tap.giving/mcp (MCP over StreamableHTTP, JSON-RPC 2.0, stateless). GET https://tap.giving/mcpreturns a short self-description for people and agents.
• Agent index: https://tap.giving/llms.txt,the site's llms.txt, names this server and links back to this repo.
• Spec: the published design and tool contracts live indocs/spec.md. The server is built and accepted:every acceptance leg passed, including the field-for-field invoiceparity check against Stripe test mode on 2026-11-07.
• This repo stays clean: README, the published spec, and thereleased server code. Working notes and anything touching privatebusiness operations live elsewhere by design.

Connect (no key anywhere)

Any MCP client connects with this block alone:

{
  "mcpServers": {
    "tap-giving": {
      "type": "http",
      "url": "https://tap.giving/mcp"
    }
  }
}

No account, key, or login exists anywhere in this server, for anytool, order status included. Order status is read with the order'sstatus reference, issued at placement and carried in the order'semail; keep it, it cannot be recovered if lost.

Claude Code, one line:

claude mcp add --transport http tap-giving https://tap.giving/mcp

Discovery, product facts, the artwork spec, and theorder questions ask nothing; exact totals come from get_quote inPart 2, at the end. Part 1 (design) carries no pricing at all. The live GET https://tap.giving/mcp self-descriptioncarries this same connect guidance.

What the server does

A design tool first: this server helps you create print-ready NFC tap artwork proofs. Work from its published spec and design directions, compose the artwork with your own tools, and submit the finished file to see it on the disc as a proof. The artwork is yours: print-ready, vendor-neutral, yours to take to any printer. Ordering discs through Tap.Giving is an optional next step, only if you want it.

The discs themselves are custom NFC tap discs, tap plates, and taptags for organizations of every kind: built for churches, nonprofits, restaurants, coffee shops, and local businesses,designed by your own agent.

Nothing in this server needs a key, a login, or an account: an agentcan discover the product, read the artwork spec with delivered exampledesigns, and submit artwork for validation before any contact exists.Part 1 (design) carries no pricing at all; exact pricing is quoted onlyat the quote step, in Part 2.

This server moves no money itself: when an order is placed, Tap.Giving emails the invoice and the design proof, and a person pays the hosted invoice. (The final step's exact label is "Email me my invoice and design proof.") Payment, design approval, and production release stay human gates: no tool takes payment, approves a design, or releases an order to production.

Tools

Worked example

One full pass through the journey, captured from the live serverwith test organizations (the orders and invoice below are testrecords). Section 1 was re-captured on 2026-11-09 from the rebuiltno-keys server; the remaining sections are the 2026-11-07 capture,amended where the 2026-11-09 model retired fields. Every field nameand value shown is exactly what the server returned; long valuesare shortened only where marked. Each result returns both thestructured content and a plain-text rendering, and both are shown.

1. get_discovery (no key)

Request:

{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_discovery", "arguments": {}}}

Response, structured content (image data shortened):

{
  "server": {
    "name": "NFC Tap Builder by Tap.Giving",
    "endpoint": "https://tap.giving/mcp",
    "synonyms": [
      "tap discs",
      "tap plates",
      "tap tags",
      "NFC tap discs"
    ]
  },
  "introduction": {
    "builder": "NFC Tap Builder by Tap.Giving",
    "positioning": "A design tool first: this server helps you create print-ready NFC tap artwork proofs. Work from its published spec and design directions, compose the artwork with your own tools, and submit the finished file to see it on the disc as a proof. The artwork is yours: print-ready, vendor-neutral, yours to take to any printer. Ordering discs through Tap.Giving is an optional next step, only if you want it.",
    "product": "A tap disc is a small physical disc a phone taps to open your page instantly. It carries a locked tap chip. It comes in one standardized 4-inch size (100 mm), in two shapes, and it is durable waterproof PVC.",
    "firstChoice": {
      "field": "shape",
      "options": [
        "round",
        "square"
      ]
    }
  },
  "journey": [
    {
      "step": "artwork spec",
      "tool": "get_artwork_spec",
      "detail": "The production geometry and the house design directions for the chosen shape."
    },
    {
      "step": "build the artwork",
      "tool": "get_artwork_spec",
      "detail": "Compose the artwork from a design direction with your own tools."
    },
    {
      "step": "submit and proof",
      "tool": "submit_artwork",
      "detail": "Submit the finished file and see it on the disc as a proof. The artwork is yours to take to any printer."
    },
    {
      "step": "order, optional",
      "tool": "get_quote",
      "detail": "Only if you want discs from Tap.Giving: the binding quote at an exact quantity, the first step of the optional order path."
    },
    {
      "step": "order questions",
      "tool": "get_order_questions",
      "detail": "The optional order path: capture the contact email first (start_order_intent), then answer the order questions. Prices are first stated here, in the order phase."
    },
    {
      "step": "recap",
      "tool": "get_recap",
      "detail": "The optional order path: the whole order, the artwork on the disc, and the exact total, checked before anything is placed."
    },
    {
      "step": "Email me my invoice and design proof.",
      "tool": "create_order",
      "detail": "The final step of the optional order path: the order is recorded, the invoice is created at the quoted total, and the invoice and the design proof are emailed to the contact. The final proof is approved by email before anything is printed."
    }
  ],
  "artworkSpec": {
    "summary": "106 mm (about 4.2 inch) square artboard; 100 mm (4 inch) cut (round or square); 3 mm (about 0.12 inch) bleed; vector artwork back (SVG preferred).",
    "tool": "get_artwork_spec"
  },
  "destination": "Every disc carries its own Tap.Giving address, so where a tap lands is set per disc. An order starts with one destination for the whole set, the page you give at order setup. To run two destinations, for example counter discs opening your menu and door discs opening your review profile, split the set afterwards in the free Redirect Dashboard: re-point any single disc, or any group of discs, in seconds, and re-point them again anytime. Your dashboard sign-in works from order setup: the address is go.tap.giving/<your-organization-slug>, the username is that slug, and the password arrives by email with the shipping notice, before your discs arrive. Tapping needs no app: iPhone XS (2018) and later and most Android phones from about 2015 read the disc automatically in the background. Where a design carries a printed QR code (your artwork includes one, or the Tap.Giving address line on the design), a phone without NFC, or with NFC off, scans that code and lands on the same destination; a design with no printed code has the tap as its only door, and the design choice is yours at artwork time.",
  "turnaround": "Production and delivery run 2 to 3 weeks from artwork approval.",
  "samples": "Samples: we do not offer physical samples, free or paid. Instead, see the finished examples and photos in this server, and when you order, a proof of your own design is emailed for approval before anything is printed. The order itself is covered by the 30-day money-back guarantee.",
  "taxExempt": "Tax-exempt organizations: say so when you order. Your tax-exempt state is recorded on the order, and tax is calculated on the invoice where it applies.",
  "plainLanguage": {
    "nfc": "NFC is the tap itself: a visitor holds a phone near the disc and the page opens. No app is needed, and nothing has to be installed.",
    "status": "There is no account, key, or login at any point. Order status is read with the one-time status reference create_order returns at placement; it is shown once and cannot be recovered, so keep it with the order confirmation."
  },
  "explainer": {
    "note": "Stuck, or explaining this to someone else? The explainer resources walk through how it works, step by step.",
    "resources": [
      {
        "uri": "tapgiving://explainer/how-it-works",
        "title": "How it works"
      },
      {
        "uri": "tapgiving://explainer/what-a-tap-disc-does",
        "title": "What a tap disc does"
      },
      {
        "uri": "tapgiving://explainer/nfc-vs-qr",
        "title": "NFC tap versus a printed QR code"
      },
      {
        "uri": "tapgiving://explainer/the-two-phases",
        "title": "The two phases: design, then order"
      },
      {
        "uri": "tapgiving://explainer/after-you-order",
        "title": "After you order"
      },
      {
        "uri": "tapgiving://explainer/materials-and-care",
        "title": "Materials and care"
      }
    ],
    "prompt": "explain_where_i_am"
  },
  "photos": [
    {
      "id": "phone-tap",
      "category": "in-use tap moment",
      "title": "A phone tapping a disc mounted on a chair back",
      "alt": "A hand holding a phone against a navy tap disc fixed to the back of a chair",
      "use": "The basic explainer: this is the tap itself, phone to disc, no app and no camera needed.",
      "displayUrl": "https://tap.giving/mcp/photos/phone-tap.webp"
    },
    {
      "id": "pews-discs-on-pews",
      "category": "church setting",
      "title": "Real installation photo: discs mounted on wooden pew backs in a sanctuary (customer not named)",
      "alt": "Rows of wooden pews in an empty sanctuary, each pew back carrying a small dark tap disc",
      "use": "Shows what a full pew installation looks like when someone asks how discs read at room scale.",
      "displayUrl": "https://tap.giving/mcp/photos/pews-discs-on-pews.webp"
    },
    {
      "id": "pews-sanctuary-wide",
      "category": "church setting",
      "title": "Real installation photo: pew rows with discs, viewed from the side aisle (customer not named)",
      "alt": "Side view down rows of wooden pews with tap discs on the pew backs in a bright sanctuary",
      "use": "Shows pew-back placement from the aisle when someone is picturing their own sanctuary.",
      "displayUrl": "https://tap.giving/mcp/photos/pews-sanctuary-wide.webp"
    },
    {
      "id": "auditorium-chairs-service",
      "category": "church setting",
      "title": "Real installation photo: discs on auditorium chair backs during a service (customer not named)",
      "alt": "Auditorium chairs with white tap discs on the seat backs, congregation standing near the stage",
      "use": "Shows discs in place on stacking chairs while a service is running.",
      "displayUrl": "https://tap.giving/mcp/photos/auditorium-chairs-service.webp"
    },
    {
      "id": "auditorium-service-view",
      "category": "church setting",
      "title": "Real installation photo: rows of auditorium chairs with discs, facing the stage (customer not named)",
      "alt": "Rows of auditorium chairs with tap discs on the backs, people gathered near a stage with screens",
      "use": "Shows the chair-back layout across a whole seating section.",
      "displayUrl": "https://tap.giving/mcp/photos/auditorium-service-view.webp"
    },
    {
      "id": "chair-back-disc-closeup",
      "category": "church setting",
      "title": "Close-up of a delivered disc on a chair back at Woodlands Church (the design names Woodlands Church)",
      "alt": "Close-up of a white oval disc screwed to an auditorium chair back; the design reads TAP YOUR PHONE HERE with a QR code and Woodlands Church printed on it",
      "use": "The clearest shot of how a finished disc looks mounted on a chair back, including the two screws.",
      "displayUrl": "https://tap.giving/mcp/photos/chair-back-disc-closeup.webp"
    },
    {
      "id": "cafe-table-disc",
      "category": "cafe-restaurant setting",
      "title": "Setting image (stock photo): a Tap.Giving sample design disc on a cafe table",
      "alt": "A cafe table with a coffee mug; a small navy sample disc with a QR code is stuck to the table edge",
      "use": "Shows table placement for a cafe or restaurant: the disc sits flat on the table where a guest can tap it.",
      "displayUrl": "https://tap.giving/mcp/photos/cafe-table-disc.webp"
    },
    {
      "id": "cafe-counter-disc",
      "category": "cafe-restaurant setting",
      "title": "Setting image (stock photo): a Tap.Giving sample design disc on a wooden cafe table",
      "alt": "A wooden cafe table with a latte; a small navy sample disc is stuck to the table corner",
      "use": "Shows a disc on a cafe table at drink height, for counter and table service conversations.",
      "displayUrl": "https://tap.giving/mcp/photos/cafe-counter-disc.webp"
    },
    {
      "id": "tap-chair-service",
      "category": "in-use tap moment",
      "title": "Tap.Giving product photography: tapping a chair-back disc during a service, giving page open on the phone",
      "alt": "From a seated position, a hand holds a phone showing a giving page against a white disc on the chair back ahead, congregation and stage beyond",
      "use": "Shows the full moment: disc, phone, and the giving page it opens. Staged product photography, not a customer photo.",
      "displayUrl": "https://tap.giving/mcp/photos/tap-chair-service.webp"
    },
    {
      "id": "tap-pew-service",
      "category": "in-use tap moment",
      "title": "Tap.Giving product photography: tapping a pew-back disc mid-service",
      "alt": "A woman seated in a pew holds her phone, showing a giving page, against a black disc on the pew back in front of her",
      "use": "Shows the pew version of the tap, from the giver's point of view. Staged product photography, not a customer photo.",
      "displayUrl": "https://tap.giving/mcp/photos/tap-pew-service.webp"
    },
    {
      "id": "tap-chairback-service",
      "category": "in-use tap moment",
      "title": "Tap.Giving product photography: phone held to a chair-back disc, congregation facing the stage",
      "alt": "Over a seated man's shoulder, a hand holds a phone against a blue disc on the chair back ahead during a service",
      "use": "Shows the disc at reading distance on a chair back in a filled room. Staged product photography, not a customer photo.",
      "displayUrl": "https://tap.giving/mcp/photos/tap-chairback-service.webp"
    },
    {
      "id": "tap-chair-rows-wide",
      "category": "in-use tap moment",
      "title": "Wide shot: rows of auditorium chairs with a disc on every seat back, one being tapped",
      "alt": "Wide view across rows of auditorium chairs, each carrying a disc; a hand holds a phone to the nearest disc",
      "use": "Shows density: what one disc per seat looks like across a room, with a tap in progress.",
      "displayUrl": "https://tap.giving/mcp/photos/tap-chair-rows-wide.webp"
    },
    {
      "id": "tap-auditorium-wide",
      "category": "in-use tap moment",
      "title": "Tap.Giving product photography: wide auditorium, discs on seat backs, a congregant tapping",
      "alt": "Wide auditorium shot with discs on the seat backs and one person tapping a disc with a phone",
      "use": "Shows a large-room installation in use. Staged product photography, not a customer photo.",
      "displayUrl": "https://tap.giving/mcp/photos/tap-auditorium-wide.webp"
    },
    {
      "id": "tap-during-worship",
      "category": "in-use tap moment",
      "title": "Tap.Giving product photography: a seated congregant taps during standing worship",
      "alt": "A congregation standing in worship while one seated person taps a chair-back disc with a phone",
      "use": "Shows that a tap takes a second and happens without leaving the seat. Staged product photography, not a customer photo.",
      "displayUrl": "https://tap.giving/mcp/photos/tap-during-worship.webp"
    },
    {
      "id": "tap-pew-during-service",
      "category": "in-use tap moment",
      "title": "Tap.Giving product photography: a pew disc with occupied pews and a speaker ahead",
      "alt": "Looking along occupied pews toward a speaker; a tap disc is fixed to the pew back in the foreground",
      "use": "Shows a pew disc in context during a service. Staged product photography, not a customer photo.",
      "displayUrl": "https://tap.giving/mcp/photos/tap-pew-during-service.webp"
    },
    {
      "id": "disc-front-and-back",
      "category": "product detail",
      "title": "Photo of a sample disc front and its 3M adhesive back",
      "alt": "Two blue sample discs on a dark surface: one face up reading TAP TO CONNECT and TAP TO GIVE, one showing the white 3M adhesive backing",
      "use": "Shows both sides of the physical product: printed face and peel-and-stick back.",
      "displayUrl": "https://tap.giving/mcp/photos/disc-front-and-back.webp"
    },
    {
      "id": "sample-disc-spec",
      "category": "product detail",
      "title": "The Tap.Giving supplier sample disc with its spec card",
      "alt": "A navy sample disc reading TAP YOUR PHONE HERE with an NFC wave and QR code above a printed spec card listing size, mounting, chip and destination",
      "use": "Shows the standard sample design and the physical spec (4 in round, 3M adhesive, NTAG213) in one frame.",
      "displayUrl": "https://tap.giving/mcp/photos/sample-disc-spec.webp"
    },
    {
      "id": "visible-church-disc",
      "category": "product detail",
      "title": "The real disc design delivered to Visible Church, shown as delivered",
      "alt": "A dark navy disc made for Visible Church: TAP YOUR PHONE HERE, an NFC wave, a QR code and the Visible Church wordmark",
      "use": "A named customer's finished disc, for showing the print quality and layout of a real order.",
      "displayUrl": "https://tap.giving/mcp/photos/visible-church-disc.webp"
    },
    {
      "id": "disc-on-wood",
      "category": "product detail",
      "title": "Photo of a black disc with screw holes lying on a wood surface",
      "alt": "A small black disc reading TAP HERE with two visible screw holes, lying on light wood",
      "use": "Shows the screw-mount variant at rest: the holes are part of the disc, nothing else to attach.",
      "displayUrl": "https://tap.giving/mcp/photos/disc-on-wood.webp"
    },
    {
      "id": "discs-stacked-production",
      "category": "product detail",
      "title": "Production photo: a hand holding a stack of finished sample discs",
      "alt": "A hand holding a thick stack of blue sample discs reading TAP TO CONNECT and TAP TO GIVE",
      "use": "Shows the discs are thin, light and stackable, straight from production.",
      "displayUrl": "https://tap.giving/mcp/photos/discs-stacked-production.webp"
    },
    {
      "id": "mount-adhesive-photo",
      "category": "mounting explainer",
      "title": "Mounting explainer: the 3M adhesive backing, close up",
      "alt": "Close-up of the white 3M 9448A adhesive backing covering the back of a disc",
      "use": "Answers how the no-screw mount works: peel the backing and press the disc onto a clean, smooth surface.",
      "displayUrl": "https://tap.giving/mcp/photos/mount-adhesive-photo.webp"
    },
    {
      "id": "mount-screws-photo",
      "category": "mounting explainer",
      "title": "Mounting explainer: a disc face showing the two screw holes",
      "alt": "Close-up of a black disc reading TAP PHONE HERE with a small screw hole at each side",
      "use": "Answers where the screws go on the screw-mount variant: one hole at each side of the disc.",
      "displayUrl": "https://tap.giving/mcp/photos/mount-screws-photo.webp"
    },
    {
      "id": "plate-with-holes",
      "category": "mounting explainer",
      "title": "Mounting explainer: a screw-mount disc on wood, both holes visible",
      "alt": "A black disc reading TAP PHONE HERE lying on wood, a pre-drilled hole at each side",
      "use": "Shows the screw-mount disc flat against a wooden surface, the way it sits once fixed.",
      "displayUrl": "https://tap.giving/mcp/photos/plate-with-holes.webp"
    }
  ],
  "capabilities": {
    "readTools": [
      "get_discovery",
      "get_quote",
      "get_product",
      "get_artwork_spec",
      "get_order_questions",
      "get_recap",
      "get_order_status"
    ],
    "writeTools": [
      "submit_artwork",
      "start_order_intent",
      "create_order"
    ],
    "artworkExport": "After submit_artwork, the submitted file stays fetchable at its displayUrl: the PRINT FILE, exactly the file the agent submitted (the agent produces the print-ready PDF from the spec; this server never builds or returns one). The same address with .png on the end returns a full-resolution PNG rendered from the submitted file. The fetch is a capability read: the artwork reference itself is the capability, within 30 days of submission. The on-disc preview is a mock composite, labeled a preview, never the print file.",
    "gates": [
      "Design approval stays human: a person approves the final proof by email before production. No tool on this server records or implies an approval.",
      "Payment stays human: This server moves no money itself: when an order is placed, Tap.Giving emails the invoice and the design proof, and a person pays the hosted invoice. A person pays the invoice when it arrives.",
      "Production release and the supplier handoff stay human: no tool on this server releases an order to production or touches fulfillment state."
    ],
    "kickoff": "get_artwork_spec",
    "benefits": [
      "Works with any platform",
      "No subscription fees",
      "Durable waterproof PVC with a locked tap chip",
      "Custom branding on every design",
      "Free shipping",
      "Covered by our 30-day money-back guarantee"
    ],
    "guarantee": "Covered by our 30-day money-back guarantee."
  }
}

Response, text rendering (complete):

NFC Tap Builder by Tap.Giving
A design tool first: this server helps you create print-ready NFC tap artwork proofs. Work from its published spec and design directions, compose the artwork with your own tools, and submit the finished file to see it on the disc as a proof. The artwork is yours: print-ready, vendor-neutral, yours to take to any printer. Ordering discs through Tap.Giving is an optional next step, only if you want it.

What it is
A tap disc is a small physical disc a phone taps to open your page instantly. It carries a locked tap chip. It comes in one standardized 4-inch size (100 mm), in two shapes, and it is durable waterproof PVC.
The discs themselves are for organizations of every kind, designed by your own agent.
NFC is the tap itself: a visitor holds a phone near the disc and the page opens. No app is needed, and nothing has to be installed.
Every disc carries its own Tap.Giving address, so where a tap lands is set per disc. An order starts with one destination for the whole set, the page you give at order setup. To run two destinations, for example counter discs opening your menu and door discs opening your review profile, split the set afterwards in the free Redirect Dashboard: re-point any single disc, or any group of discs, in seconds, and re-point them again anytime. Your dashboard sign-in works from order setup: the address is go.tap.giving/<your-organization-slug>, the username is that slug, and the password arrives by email with the shipping notice, before your discs arrive. Tapping needs no app: iPhone XS (2018) and later and most Android phones from about 2015 read the disc automatically in the background. Where a design carries a printed QR code (your artwork includes one, or the Tap.Giving address line on the design), a phone without NFC, or with NFC off, scans that code and lands on the same destination; a design with no printed code has the tap as its only door, and the design choice is yours at artwork time.
A scannable QR code appears on a disc only when the design carries a printed code; the tap works either way.

How it works: the design path first
1. Start with the shape, round or square.
2. Get the artwork spec and the design directions for that shape from get_artwork_spec.
3. Build the artwork from a direction with your own tools, adding the organization's logo or name.
4. Submit the finished file with submit_artwork and see it on the disc as a proof. The artwork is yours from here: take it to any printer, or order the discs from Tap.Giving.
5. Optional, only if you want the discs made: get the binding quote from get_quote.
6. Capture the contact email first (start_order_intent), then answer the order questions (get_order_questions). Prices are first stated at the order questions, in the order phase.
7. Check the recap (get_recap): the whole order, your artwork on the disc, and the exact total.
8. Final step, Email me my invoice and design proof (create_order): the order is recorded, the invoice is created at the quoted total, and the invoice and the design proof are emailed to the contact. The final proof is approved by email before anything is printed.

Why Tap.Giving
- Works with any platform
- No subscription fees
- Durable waterproof PVC with a locked tap chip
- Custom branding on every design
- Free shipping
- Covered by our 30-day money-back guarantee
Every order is covered by our 30-day money-back guarantee. Tax, where it applies, is calculated on the invoice. Production and delivery run 2 to 3 weeks from artwork approval.
Samples: we do not offer physical samples, free or paid. Instead, see the finished examples and photos in this server, and when you order, a proof of your own design is emailed for approval before anything is printed. The order itself is covered by the 30-day money-back guarantee.

Gates
Design approval, payment, and production release stay human: a person approves the final proof by email. This server moves no money itself: when an order is placed, Tap.Giving emails the invoice and the design proof, and a person pays the hosted invoice.
There is no account, key, or login at any point in using this server. Order status is read with the status reference create_order returns at placement; it is shown once and cannot be recovered. Stuck? The explainer resources (tapgiving://explainer/how-it-works and its topics) walk through where you are.
The photo with this answer shows the disc in use: a phone tapping a disc on a chair back. The structured photos list the labeled photo set from the website library (settings, tap moments, product details, mounting): show them whenever the person wants to see the disc in place.

2. get_quote at 250 (no key)

Request:

{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "get_quote", "arguments": {"quantity": 250}}}

Response, structured content:

{
  "quantity": 250,
  "tier": "200-399 discs",
  "unitCents": 400,
  "discUnitCents": 400,
  "discSubtotalCents": 100000,
  "discount": {
    "code": "WELCOME10",
    "percentOff": 10,
    "scope": "first order",
    "window": "7-day renewing window",
    "appliedInHeadlineTotals": false,
    "conditionalTotalCents": 90000
  },
  "addOns": [],
  "addOnCents": 0,
  "shippingCents": 0,
  "shippingLine": "Shipping: Free",
  "taxNote": "Tax, where it applies, is calculated on the invoice.",
  "grandTotalCents": 100000,
  "grandTotalWithFirstOrderDiscountCents": 90000,
  "currency": "USD"
}

Response, text rendering:

Quote for 250 discs (200-399 discs): $1,000.00 total.
Discs: 250 at $4.00 list, $1,000.00 list subtotal. First orders take 10 percent off with code WELCOME10 inside a 7-day renewing window: $900.00 when it applies.
Add-ons: none.
Shipping: Free
Tax, where it applies, is calculated on the invoice.

The headline total is the list total, $1,000.00. The first-orderdiscount is a conditional line only: $900.00 when it applies, neverbaked into the headline.

3. submit_artwork (no key, no email)

A 1-pixel PNG stands in for the agent-built artwork file here; thesha256 is the real hash of those bytes. This call was made with nocredential: none exists in this server.

Request:

{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "submit_artwork", "arguments": {"file": {"filename": "worked-example.png", "mediaType": "image/png", "contentBase64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="}, "sha256": "c414cd0e204de974f73753c7e28d7638e7b3691bb8b1a2bab6b25bb7fed7ce77"}}}

Response, structured content:

{
  "received": true,
  "artworkRef": "art_fc94d730591f03bab798edfe",
  "displayUrl": "https://tap.giving/mcp/artwork/art_fc94d730591f03bab798edfe",
  "sha256": "c414cd0e204de974f73753c7e28d7638e7b3691bb8b1a2bab6b25bb7fed7ce77",
  "validation": {"policy": "permissive", "checks": {"notMalicious": true, "sizeOk": true, "decodable": true}, "findings": ["accepted; vector preferred for production"]},
  "benefits": ["Works with any platform", "No subscription fees", "Durable waterproof PVC with a locked tap chip", "Custom branding from 100 discs", "Free shipping", "Covered by our 30-day money-back guarantee"],
  "preview": {"kind": "on-disc", "shapes": ["round", "square"], "note": "Your design on the disc, cut shape applied. This preview render is the design check at this stage; nothing is emailed at the artwork stage, because no contact is captured yet. The emailed final proof belongs to the order stage, after order setup."},
  "nextStep": "Show the person their design on the disc (the preview image), then capture the contact email at order setup (start_order_intent) and ask the order questions (get_order_questions)."
}

The result also carries the submitted design composited on the discback as image content blocks, one per shape when no shape was given,and its text rendering opens with the test-mode banner, then:"Artwork received: art_fc94d730591f03bab798edfe(worked-example.png, png, 70 bytes)."

4. create_order (no key, idempotency key)

Between artwork and order, get_recap returns a recapRef for theexact inputs the person saw (its cost object is the get_quoteobject above); create_order carries that recapRef. The recap forthis pass was recap_f562143ce62c3282468a7670, with the contactemail among its inputs.

Request:

{"jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": {"name": "create_order", "arguments": {"contactName": "MCP Acceptance", "contactEmail": "[email protected]", "contactPhone": "+17135550199", "organizationName": "MCP Acceptance Test Organization", "quantity": 250, "size": "100mm-round", "mounting": "adhesive", "artworkRef": "art_2ce8de191f7035de811e224b", "recapRef": "recap_f562143ce62c3282468a7670", "exit": "pay_now", "idempotencyKey": "worked-example-2026-11-07-01", "shipTo": {"name": "MCP Acceptance Test Organization", "street": "100 Test Way", "city": "Spring", "state": "TX", "postalCode": "77380", "country": "US", "phone": "+17135550199"}}}}

Response, structured content (abbreviated; the full quote objectfrom step 2 rides as quote):

{
  "orderRef": "mcp:mcp-acceptance-test-church:93f3ebe22527b0b7",
  "invreqKey": "INVREQ:2026-11-07T21:45:50.340Z:[email protected]",
  "exit": "pay_now",
  "quote": {"quantity": 250, "tier": "200-399 discs", "grandTotalCents": 100000},
  "nextStep": "The order is placed. A person from Tap.Giving follows up with the invoice for this order; the person pays it when it arrives."
}

A retry with the same idempotency key and the same payload returnsthis same orderRef; the same key with a different payload is aconflict naming the differing fields.

5. The final step: "Email me my invoice and design proof."

Placing the order in step 4 fires the final step, labeled exactly"Email me my invoice and design proof.": the order is recorded inthe CRM (the invreqKey in the step 4 response), the full order isemailed to the Tap.Giving team (the response's orderEmail confirmsthe send), a Stripe invoice is created and finalized at the quotedtotal, and the invoice plus the design proof are emailed to thecustomer, the proof embedded in the email and attached. (Thissupersedes the 2026-11-08 P-16 flow, under which placement mintedno invoice; Ryan's ruling of 2026-11-09 governs.)

Reading the order back afterwards is get_order_status with theorder's statusRef from the step 4 response (a capability, not akey; only its hash is stored).

Errors

Every tool error returns MCP's standard error content (a text blockreading code: message) plus a structured object:{code, message, retryable, details}. The details object carrieswhat an agent needs to act, for example the differing fields on aconflict. No error ever returns another organization's data, a stacktrace, or a secret.

The distinction agents most often get wrong: not_found is what an unknown or unbound reference returns on every read path; there are no credential errors to confuse it with (the credential codes are retired, above).

This catalog is current as of 2026-11-07, when the live-modeinvoice refusal (invoice_parity_pending) was lifted after thefield-for-field parity check passed; that code no longer exists inthe server.

No keys

There are no keys. No user-facing step in this server requires oroffers a key, login, or account, including placing an order andreading its status. Connect with the endpoint URL alone. Orderstatus is read with the order's status reference, a capabilityissued at placement and carried in the order's email; only its hashis stored, and it cannot be recovered if lost.

A registry record for this server lives in this repo asserver.json, in the official MCP Registry format:the namespace-tied name, a short description, the server version,and the remote endpoint. The record is created and validated;publishing it to the registry is a separate step, so the server isnot listed yet.

Development

npm install
npm test          # contract tests against the published fact set
npm run typecheck
npx wrangler dev  # local run

Secrets (Stripe keys per mode, the invocation-seat secret) are setwith wrangler secret put and are never committed.