Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "request_status"
Resume a requirement using the receipt credentials. Read the recorded requirement, any replies the business has published on it (messages: where it answers a buyer with no email, it answers here) and any linked offers. Answer a reply by sending a continuation. Contact details are kept apart.
Added "edit_requirement", "get_requirement", "interpret_requirement" and 1 more (23 tools before, 27 now)
Change a requirement by field — Set fields by name ({"op":"set","values":{...}}, an empty value clears) or change the list ({"op":"add"|"update"|"remove"|"replace", ...}), exactly as given: no reading. Use it to answer the open question when the answer is a value.
Read a requirement as it stands — A Plumbline requirement as it stands: each value with where it came from, what it replaced, the open question, words not yet read, whether it was sent and any offer on it.
Describe a need to Plumbline in words — Give Plumbline the buyer's requirement, or a correction or addition to it, in their own words: it is read into a structured requirement (each value says which words it came from), conflicting or unclear facts come back as one question, and words not yet read are kept as written. Pass the requirement (id, token) from the first answer to continue it. Nothing is sent or ordered: send_requirement sends it when the buyer says so. When you already have the fields in structured form, use submit_request instead.
Added "answer_remedy", "counter_offer", "get_order_draft" and 8 more; changed the definition of "accept_offer", "company_financial_facts", "decline_offer" and 9 more (12 tools before, 23 now)
acceptAccept an offer and place the order
⟨7 unchanged words⟩ ,"type":"boolean"},"id":{"description":"The request or offer id from your receipt or customer link","format":"uuid","pattern":"^([0-9a-fA-F ⟨74 unchanged words⟩
Certificate recorded, valid to 2027-02-02
Authorization not required
Added "retrieve_deliverable" (11 tools before, 12 now)
retrieve deliverable — Retrieve what a paid order delivers, where the business produces it itself (a report): the exact text, its SHA-256, version, sources and any shortfall. Before payment is confirmed it says it is not yet available. Use the offer link or linked request credentials.
Added "accept_offer", "decline_offer", "inspect_offer" and 2 more; removed "entity_lookup"; changed the definition of "submit_request" (7 tools before, 11 now)
⟨82 unchanged words⟩ "string"}},"type":"object"},"continuation":{"properties":{"id":{"format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","type":"string"},"token":{"pattern":"^[0-9a-f]{48}$","type":"string"}},"required":["id","token"],"type":"object"},"geography":{"properties":{"country":{"type ⟨91 unchanged words⟩
accept offer — Place an order on terms you have inspected and the buyer has authorized you to accept. Requires the exact terms hash and explicit acceptance. Follow inspect_offer later for payment links and verified payment state.
Changed the definition of "submit_request"
⟨33 unchanged words⟩ "contact":{"description":"Optional; stored apart from the requirement, kept while we correspond or do business anddeletedfor 24 months after,180thendaysdeleted; you can ask us to delete it sooner (a service may state a different period on its page)","properties":{"email":{"type": ⟨104 unchanged words⟩
Unknown → Live
First tool surface recorded: 7 tools (server version 1.0.0)
https://plumbline.forevenza.com/mcp (mcp_streamable_http) — from mcp_registry, with the record
Showing the latest 11 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
Send the requirement — Send the requirement to Plumbline once the buyer says to: the first send records the request (its receipt token is the requirement's token, for request_status and offers); a later send of a changed requirement records a revision of the same request. Name the revision the buyer saw. This orders nothing: an offer comes later and is accepted separately on its exact terms.
ReportedXBRLvalues of one XBRL concept for one SEC filer, by CIK or ticker, from its SEC filings (EDGAR): each value with its period, fiscal year, form, filing date and accessionnumber.number, the latest 40.
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"cik":{"description":"SEC CIK; or give ticker","maxLength":10,"type":"string"},"concept":{"description":"XBRL concept name, default Revenues; others include RevenueFromContractWithCustomerExcludingAssessedTax, NetIncomeLoss, Assets","maxLength":120,"type":"string"},"taxonomy":{"description":"Default us-gaap","enum":["us-gaap","ifrs-full","dei"],"type":"string"},"ticker":{"description":"Stock ticker of an SEC filer, such as AAPL","maxLength":10,"type":"string"}},"type":"object"}
declineDecline an offer
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"id":{"description":"The request or offer id from your receipt or customer link","format":"uuid","pattern":"^([0-9a-fA-F ⟨60 unchanged words⟩
Describe a Plumbline service
Everything about one Plumbline service, by the slug list_propositions gives: what happens to a request, what yougetreceive, scope and limits, the request fields with examples, andanytheoperations.lookups it runs.
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"slug":{"description":"A slug from list_propositions, such as \"company-financials\"","maxLength":80,"type":"string"}}," ⟨4 unchanged words⟩
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"fiscal_year":{"description":"Federal fiscal year","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"naics":{"description":"NAICS industry code","maxLength":6,"type":"string"},"recipient":{"description":"Vendor name as reported to FPDS","maxLength":200,"type":"string"},"start":{"description":"next_start from the previous page","maximum":9007199254740991,"minimum":0,"type":"integer"},"state":{"description":"Place-of-performance state, two letters","maxLength":2,"type":"string"}},"type":"object"}
inspectInspectofferan offer's terms and thread
⟨5 unchanged words⟩ terms hash, order state and processor paymentlinks.links, and the thread the business published on the offer: its answers to counteroffers (thread.counteroffers), the purchasing requirements, vendor status and purchase order matches it holds (thread.purchasing), and the portions, shortfall and remedies of delivery (thread.fulfilment). Use the offer link credentials, or credentials ⟨8 unchanged words⟩
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"id":{"description":"The request or offer id from your receipt or customer link","format":"uuid","pattern":"^([0-9a-fA-F ⟨46 unchanged words⟩
List Plumbline's serviceswith(Reported financial figures for US public companies; Legal entity verification by name, LEI or CIK; US federal contract awards by recipient, industry or place; Screen aone-linenamesummaryagainst the OFAC SDN list):lookupseachthatone'srunslug,instantlya one-line summary, andrequirementswhetheryouitcanruns instantly as a lookup or takes a requirement you send.
releaseRelease a payment condition
⟨7 unchanged words⟩ ,"type":"boolean"},"id":{"description":"The request or offer id from your receipt or customer link","format":"uuid","pattern":"^([0-9a-fA-F ⟨67 unchanged words⟩
Check a requeststatusand its offers
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"id":{"description":"The request or offer id from your receipt or customer link","format":"uuid","pattern":"^([0-9a-fA-F ⟨46 unchanged words⟩
retrieveRetrieve a paid order's deliverable
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"id":{"description":"The request or offer id from your receipt or customer link","format":"uuid","pattern":"^([0-9a-fA-F ⟨46 unchanged words⟩
Screen a person or company name against the US Treasury OFAC SDN list andaliases.its aliases (US OFAC SDN only: not the EU, UK or UN lists). Returns each match with its score, SDN entry number, type and programs, and the date the list was published. A match is a lead for review, not a determination.
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"min_score":{"description":"Lowest similarity returned, 0.5 to 1; default 0.82","maximum":1,"minimum":0.5,"type":"number"},"name":{"description":"The person's or company's name as written; aliases are searched too","maxLength":200,"type":"string"}}, ⟨4 unchanged words⟩
Send a requirement toonePlumblineof(ReportedPlumbline'sfinancialservices.figures for US public companies; Legal entity verification by name, LEI or CIK; US federal contract awards by recipient, industry or place; Screen a name against the OFAC SDN list). It iskeptrecorded and answered with areferencereceipt:number.keep its id and token to read the request's status (request_status), to add details later (continuation), and to act on an offer made in reply. A requirement is not an order and costs nothing; nothing is bought until an offer's exact terms are accepted.
⟨83 unchanged words⟩ ,"type":"object"},"continuation":{"description":"The receipt id and token of an earlier request, to add to it instead of opening a new one","properties":{"id":{"format":"uuid" ⟨130 unchanged words⟩
Answer a proposed remedy — Accept or decline a remedy the business proposed on a placed order (inspect_offer thread.fulfilment.remedies with state PROPOSED). Recorded for the business, which applies it and shows the result there. Accepting a credit or refund here moves no money; the business records it when its payment processor does.
Propose changes to an offer — Propose a change to an issued offer on its inspected terms: other quantities (by item index in terms.items), another list of companies (where the items price companies), a delivery date, a total price for the whole, a payment plan, or a note. It is a proposal, not a change: the terms stand and can still be accepted as they are. The business answers it in inspect_offer thread.counteroffers, with a revised offer to inspect and accept, or a reason. A later proposal replaces an earlier one still awaiting an answer. Nothing here orders or pays.
Read the order draft — Read a Plumbline order draft as it stands: its fields and companies (with their keys), what it still needs before it can be sent, the indicative price, what changed since it was sent, the firm offer with its terms hash, the order, payment and report state, recent changes by the buyer in the app or by you, and what can happen next. Read it before acting on what the buyer says about the order: they may have changed it in the app.
Identify a company (LEI and SEC filer) — Which legal entities a company name may mean: GLEIF LEI records that match it (legal name, country, city, status) and, for a company listed in the US, its SEC filer CIK. For choosing the exact entity to verify before ordering; these are candidates, not findings. Free.
Record a delivery inspection — Record the buyer's inspection of a placed order: for each item (its index in terms.items) the quantity accepted and the quantity rejected, with a reason for a rejection, optionally for one portion of the order. Whether it was accepted is computed: only when nothing is rejected. Recorded for the business, which answers a rejection in inspect_offer thread.fulfilment, with a proposed remedy. Nothing here pays or refunds.
Report vendor approval status — Report the seller's vendor standing with the buyer's organization (APPROVED, DOCUMENTS_REQUESTED or REJECTED) with the buyer's approval or case reference and any documents requested. Recorded as the buyer's own statement; the business answers it in inspect_offer thread.purchasing.
Send the order draft as a request — Send a Plumbline order draft once the buyer has said to: the first send records the request (the firm offer with its exact price and terms hash is emailed to the buyer and appears in the app when ready; promise no time); a later send of a changed list records a revision of the same request and declines the offer for the earlier list as replaced. Name the revision the buyer saw: a draft that changed since is not sent. Needs the buyer's email on the first send (where the offer and receipt go). This places no order: the buyer accepts the firm offer separately.
State the buyer's purchasing requirements — Tell the business how the buyer's purchasing works for this offer: whether the seller must be an approved vendor, whether a purchase order is required, which documents are needed, the seller's vendor id with the buyer, where orders and invoices go, and the payment terms. Recorded as the buyer's statement; the business answers it in inspect_offer thread.purchasing. Nothing here orders or pays.
Send a purchase order — Send the buyer's purchase order for an issued offer or a placed order: number, revision, lines, total, currency and payment terms. It is matched against the accepted terms; differences are recorded and shown in inspect_offer thread.purchasing as exceptions, never silently accepted. A changed purchase order is the same number with a higher revision. This does not accept the offer and pays nothing.
Change the order draft — Change a Plumbline order draft the way the buyer asked: add, update, remove or replace companies (name an item by its key from the draft, or by match on its name), or clear the list (item fields: name (the company's name as the buyer has it, or its exact legal name); country (ISO 3166 two-letter code; narrows the LEI search by name); lei (20-character Legal Entity Identifier; the report then reads that exact record); cik (SEC Central Index Key; adds the SEC EDGAR registration (EDGAR is not searched by name))). The app in the conversation shows the change at once. A placed order is never chang…
Verify suppliers with Plumbline — Open Plumbline's supplier verification workspace in the conversation, with the companies the buyer named. It starts an order draft the buyer and you work on together: they can add, correct and identify companies in the app, and you change the same draft with update_order_draft when they ask in words ("add Microsoft", "replace Apple with Nvidia"); both of you see the same list and price. The report screens each company against the US Treasury OFAC SDN list, reads its GLEIF LEI record and, where a CIK is given, its SEC EDGAR registration; every finding names its source and time, and the report …
decline offer — Decline an issued offer on its inspected terms.
inspect offer — Read the exact authorized terms, terms hash, order state and processor payment links. Use the offer link credentials, or credentials of the request explicitly linked to this offer.
release payment — Confirm a payment condition only where the inspected order allows the customer to release it. This records approval; it does not pay the processor.
request status — Resume a requirement using the receipt credentials. Read the recorded requirement and any linked offers. Contact details are kept apart.
Company registration lookup (LEI and SEC) — LEI records and SEC EDGAR registration for a company. Paid per call over HTTP with x402 ($0.02); this tool returns how to call it.