mcp server · observation history
io.github.lonniev/optionality-mcp
Observed since 2026-08-30, last seen 2026-10-17. Currently reachable. 8 contract changes recorded, 1 of them breaking. That is rank 411 of 20,719 observed servers by breaking changes.
What this server does
In its own words. Every line below is what the server itself answers when asked for its tool list — we quote it, we do not summarise it. The wording is the operator's, not ours.
| Tool | What the server says it does |
|---|---|
optionality_account_statementneeds: dpop_token, npub | Generate a patron's account statement at this operator. Returns the patron's purchase history, active credit tranches, per-tool usage breakdown, and recent daily usage logs. This is the patron's spending account â not the operator's Authority tax balance. Free â no credits consumed. Proof of npub ownership is required to prevent statement-scraping of arbitrary patrons. |
optionality_account_statement_infographicneeds: dpop_token, npub | Generate a visual SVG infographic of your account statement. Returns the same data as account_statement, rendered as a dark-themed SVG graphic with balance hero, metrics cards, health gauge, tranche table, and tool usage breakdown. Costs 1 api_sat per call. Proof is verified by ``debit_or_deny`` before any cost is incurred. |
optionality_adoption_statusneeds: authority_npub | Check this operator's adoption-request status at a chosen Authority. Free. Polls the Authority MCP-to-MCP for the status of this operator's request (pending / approved / rejected / provisioned). |
optionality_ask_tipneeds: entry_id, question | Get a non-spoiler Socratic hint for an open journal entry. |
optionality_check_authority_balanceno arguments | Check this operator's tax balance at the Authority. Returns the sats available for certifying patron credit purchases. When this balance reaches zero, patron top-ups cannot be certified and the operator must call purchase_credits on the Authority. This is the operator's own funding â not a patron balance. Free. |
optionality_check_balanceneeds: dpop_token, npub | Check a patron's credit balance at this operator. This is the patron's spending balance â credits purchased via Lightning for tool calls at this operator. For the operator's own balance at the Authority (needed to certify patron purchases), use authority_check_balance instead. Free â no credits required. Proof of npub ownership is required to prevent anyone-with-the-registry from enumerating |
optionality_check_paymentneeds: dpop_token, invoice_id, npub | Check the payment status of a Lightning invoice. Call after paying the invoice from purchase_credits. Free â no credits required. Proof of npub ownership is required to prevent credit-grant front-running by an observer of the invoice ID. |
optionality_check_priceneeds: tool_id | Preview the effective cost of a tool call. Shows the base cost and any constraint effects (discounts, free trials, surge pricing). Free â no credits required. |
optionality_check_proof_statusno arguments | Check whether a proof grant is still valid. Mirrors ``check_oauth_status`` for the npub-proof flow: a calling agent can ask "will my next paid call accept this dpop_token?" before burning credits on a guaranteed failure. Expiry is read from the grant itself; the only store consulted is the patron's revocation watermark. Free, no side effects â touches no relay. |
optionality_deal_scenarioneeds: difficulty, mode | Generate a fresh options trading scenario and open a journal entry. |
optionality_delete_couponneeds: coupon_id | Delete a coupon. Cascades to all patron redemptions. Any chain step referencing the deleted coupon_id becomes a no-op (the constraint returns neutral on unknown ids) â the Studio surfaces orphan references as warnings. RESTRICTED to operator â requires proof. |
optionality_delete_journalneeds: entry_id | Hard-delete a journal entry and recompute the leaderboard cache. |
optionality_delete_operator_credentialneeds: dpop_token, field | Remove a single operator secret field. Deletes one key from the operator's encrypted credential blob without touching the others â the field-level counterpart to ``forget_credentials``, which wipes the whole row. Use it to retire a leftover after an SDK cutover (a Prefect key after Modal, or a stored but untemplated orphan like ``anthropic_api_key``) without taking the operator down for a full |
optionality_delete_patron_credentialneeds: dpop_token, field, npub | Remove a single patron credential field. Deletes one field from stored credentials without affecting other fields. Free. Proof of npub ownership is required â this is a write to the patron's sensitive credential vault. |
optionality_escrow_nsecneeds: nsec | Deposit a freshly-generated nsec for operator-managed Nostr signing. Trade-off: sovereignty for UX. Optionality holds the nsec encrypted in Neon (AES-256-GCM, key derived from operator nsec). Until you withdraw it, the operator can sign Nostr DMs on your behalf. Use this only for fresh game-persona keypairs â never for an existing Nostr identity that lives elsewhere. The nsec MUST derive to th |
optionality_fetch_judgementneeds: claim_check | Redeem a judge_trade claim check. Free. While ``status`` is ``running``, wait ``poll_after_seconds`` and call again. When ``done``, ``result`` holds the judge_trade response (``entry_id`` + ``evaluation``). ``expired`` means the claim is unknown or its result aged out â submit the trade again. |
optionality_fetch_scenarioneeds: claim_check | Redeem a deal_scenario claim check. Free. While ``status`` is ``running``, wait ``poll_after_seconds`` and call again. When ``done``, ``result`` holds the deal_scenario response (``entry_id`` + ``scenario``). ``expired`` means the claim is unknown or its result aged out â start a new deal_scenario request. |
optionality_fetch_tipneeds: claim_check | Redeem an ask_tip claim check. Free. While ``status`` is ``running``, wait ``poll_after_seconds`` and call again. When ``done``, ``result`` holds the ask_tip response (``tip``). ``expired`` means the claim is unknown or its result aged out â ask again. |
optionality_forget_couponneeds: coupon_id, npub | Remove a coupon from this patron's redemption list. Cosmetic only â the coupon itself still exists at the operator, and the patron can re-redeem the same code later while the window allows. Free â requires proof of ``npub``. |
optionality_forget_credentialsneeds: dpop_token, npub, service | Delete vaulted credentials for a specific service and npub. For operator credentials, pass the operator's own npub. For patron credentials, pass the patron's npub. Always requires proof of npub ownership â a deletion is as destructive as a write. |
optionality_get_api_usage_statsno arguments | Aggregated LLM usage and cost for this patron's calls. Returns ``{"models": [{"model", "runs", "total_calls", "total_input_tokens", "total_output_tokens", "total_cost_usd", "priced_runs"}, ...], "totals": {...}}``. One row per distinct model the patron's tool calls have invoked. ``total_cost_usd`` is what the PROVIDER reported for those calls, not a figure reconstructed from a price table â to |
optionality_get_escrow_statusno arguments | Return ``{"escrowed": bool}`` â whether Optionality holds the patron's nsec. Free; the FE polls this to render Withdraw vs Deposit affordances on the Profile page. |
optionality_get_journalneeds: entry_id | Return the full journal entry including scenario + evaluation. |
optionality_get_leaderboardno arguments | Global leaderboard ordered by ``sort_by``. |
optionality_get_my_rankno arguments | The caller's leaderboard row plus their ordinal rank under ``sort_by``. |
optionality_get_nostr_profileno arguments | Read an npub's public Nostr profile (NIP-01 kind-0 metadata). Free, no proof â the data is already public on relays. Returns the latest metadata fields (name, display_name, about, picture, banner, nip05, website, lud16) or an empty profile if none is published. |
optionality_get_notarization_proofneeds: notarization_id, npub | Generate a Merkle inclusion proof that a patron's balance was included in a Bitcoin-notarized snapshot. |
optionality_get_operator_onboarding_statusno arguments | Report this operator's configuration readiness. Shows which operator settings are configured, which are missing, and how to deliver each missing value. For patron-level credential status, use get_patron_onboarding_status instead. Free. |
optionality_get_patron_credential_fieldsneeds: dpop_token, npub | List stored patron credential field names (not values). Returns the names of fields stored for a patron, plus each field's ``delivered_at`` ISO-8601 timestamp when known (null for secrets vaulted before timestamps were recorded). Values are never exposed â use this to verify which fields are configured and how old each one is. Free. Proof of npub ownership is required: the list of configured fi |
optionality_get_patron_onboarding_statusneeds: dpop_token, patron_npub | Report a patron's credential readiness for this operator. For set-once services (eXcalibur, TheBrain), shows which patron secrets are configured and which are missing. For dynamic/OAuth2 services (Schwab), reports that no patron credentials are needed. Free. Proof of npub ownership is required because credential presence is sensitive information about the patron's setup. |
optionality_get_patron_profileno arguments | Return the caller's profile â display_name, avatar, bio, relays. |
optionality_get_pricing_modelno arguments | Get the active pricing model for this operator. Free. If no model exists, self-initializes a scaffold with all registered tools at 0 sats. No economic data from code. |
optionality_get_shared_entriesneeds: target_npub | List a target patron's shared evaluated entries â newest first. Public, free read: anyone (including guests) can browse the trades a leaderboard peer has chosen to share. Eager-loads the evaluation and trade proposal so the FE can render the full assessment with no follow-up call. No npub/proof envelope â this is a bootstrap-style tool the FE invokes without identity injection. |
optionality_judge_tradeneeds: entry_id, trade_proposal | Evaluate the trainee's trade. Persists evaluation, parses legs, recomputes leaderboard. |
optionality_list_canonical_identitiesno arguments | Return canonical (tool_id, mcp_name, â¦) for every tool the wheel exposes. The authoritative source for any client (Studio, agents, FE) that needs to know how this MCP identifies its tools. Reconcile uses this output to UUID-join against the stored pricing model â no name-based UUID derivation, no guessing. Includes both ToolIdentity-seeded tools and any UUID recorded by ``@paid_tool`` that i |
optionality_list_constraint_typesno arguments | List all available constraint types and their parameter schemas. Returns the type, category, description, and parameter specs for every constraint that can be used in a pricing pipeline. Free â no credits required. |
optionality_list_couponsno arguments | List every coupon this operator has minted (newest first). Each row carries the current ``times_redeemed`` counter â the Studio renders a progress bar from this against ``total_uses``. RESTRICTED to operator â requires proof. |
optionality_list_journalno arguments | Server-side sorted, grouped, paginated list of the caller's journal. Sorting and grouping are done in SQL, so each page is a slice of the fully-ordered dataset. Returns ``{total, page, page_size, groups, entries}``; ``groups`` carries per-group counts over the whole set. |
optionality_list_my_couponsneeds: npub | List the coupons this patron has redeemed on this operator. Returns both active and exhausted redemptions with a per-row ``status`` (``active`` / ``window_closed`` / ``patron_limit`` / ``total_limit``). Free â requires proof of ``npub``. |
optionality_list_notarizationsno arguments | List recent Bitcoin notarization records. |
32 further tools not shown.
Current claim
What this server says about itself, as of our last probe. Every value carries the date it was recorded.
| Endpoint | https://optionality-mcp.fastmcp.app/mcp |
| Reachable | yes |
| Auth scheme | Bearer |
| Latency class | 3-10s |
| Protocol version | 2025-06-18 |
| Tools | 72 |
| First observed | 2026-08-30 |
| Last seen | 2026-10-17 |
| Went silent | — |
| Contract changes | 8 |
| Breaking changes | 1 |
What changed, and when
Each row is a recorded fact. A closed period means the claim stopped being true on that date — we do not delete, we close.
| Claim | Value | Period | Recorded |
|---|---|---|---|
| mcp_reachable | {'auth': 'Bearer', 'value': True, 'transport': 'streamable-http'} | from 2026-08-30 | 2026-10-17 |
| mcp_auth_scheme | {'value': 'Bearer', 'challenge': 'Bearer resource_metadata="https://optionality-mcp.fast | — | 2026-10-17 |
| mcp_contract_change | {'value': 'breaking', 'compared': {'this_probe': '2026-10-17T19:23:25+00:00', 'previous_ | — | 2026-10-17 |
| mcp_server_version | {'name': 'optionality-mcp', 'version': '0.7.4'} | — | 2026-10-15 |
| mcp_contract_change | {'value': 'cosmetic', 'compared': {'this_probe': '2026-10-15T01:17:40+00:00', 'previous_ | — | 2026-10-15 |
| mcp_tools | {'tools': [{'name': 'optionality_account_statement', 'optional': ['days'], 'required': [ | — | 2026-10-15 |
| mcp_tool_count | {'value': 72} | — | 2026-10-13 |
| mcp_contract_change | {'value': 'compatible', 'compared': {'this_probe': '2026-10-13T01:15:09+00:00', 'previou | — | 2026-10-13 |
| mcp_tools | {'tools': [{'name': 'optionality_account_statement', 'optional': ['days'], 'required': [ | — | 2026-10-13 |
| mcp_tools | {'tools': [{'name': 'optionality_account_statement', 'optional': ['days'], 'required': [ | — | 2026-10-08 |
| mcp_contract_change | {'value': 'compatible', 'compared': {'this_probe': '2026-10-08T13:13:01+00:00', 'previou | — | 2026-10-08 |
| mcp_tools | {'tools': [{'name': 'optionality_account_statement', 'optional': ['days'], 'required': [ | — | 2026-09-29 |
| mcp_contract_change | {'value': 'cosmetic', 'compared': {'this_probe': '2026-09-29T19:17:03+00:00', 'previous_ | — | 2026-09-29 |
| mcp_tools | {'tools': [{'name': 'optionality_account_statement', 'optional': ['days'], 'required': [ | — | 2026-09-29 |
| mcp_contract_change | {'value': 'cosmetic', 'compared': {'this_probe': '2026-09-29T01:05:48+00:00', 'previous_ | — | 2026-09-29 |
| mcp_contract_change | {'value': 'cosmetic', 'compared': {'this_probe': '2026-09-27T19:10:42+00:00', 'previous_ | — | 2026-09-27 |
| mcp_tools | {'tools': [{'name': 'optionality_account_statement', 'optional': ['days'], 'required': [ | — | 2026-09-27 |
| mcp_latency_ms | {'bucket': '3-10s', 'method': 'Klassenwechsel erst nach zwei Messungen in Folge'} | — | 2026-09-05 |
| mcp_server_version | {'name': 'optionality-mcp', 'version': '3.4.7'} | — | 2026-08-30 |
| mcp_contract_change | {'value': 'cosmetic', 'compared': {'this_probe': '2026-08-30T18:57:01+00:00', 'previous_ | — | 2026-08-30 |
| mcp_auth_scheme | {'value': 'open'} | — | 2026-08-30 |
| domain_verified | {'note': 'Registry vergibt den Namensraum nur nach Domain-Nachweis; geprueft wird, ob de | — | 2026-08-30 |
| mcp_reachable | {'auth': 'open', 'value': True, 'transport': 'streamable-http'} | from 2026-08-30 | 2026-08-30 |
| mcp_tool_count | {'value': 71} | — | 2026-08-30 |
| mcp_server_version | {'name': 'optionality-mcp', 'version': '3.3.1'} | — | 2026-08-30 |
| mcp_tools | {'tools': [{'name': 'optionality_account_statement', 'optional': ['days'], 'required': [ | — | 2026-08-30 |
| mcp_latency_ms | {'bucket': '<1s', 'method': 'Klassenwechsel erst nach zwei Messungen in Folge'} | — | 2026-08-30 |
| mcp_protocol_version | {'value': '2025-06-18'} | — | 2026-08-30 |
Machine access — free, no API key
Every figure shown here about io.github.lonniev/optionality-mcp — MCP observation history can also be queried live: FACTANKER runs an MCP server at https://factanker.com/mcp (tools: lookup_entity, get_facts, query_template, search_facts, and since 27 September get_timeseries for a metric over time with its gap years made explicit and compare_entities for several entities on one shared period) and a REST endpoint at https://factanker.com/api/get_facts. Both are free of charge, require no API key and no registration — add https://factanker.com/mcp as a connector in Claude, ChatGPT or Copilot. Every answer carries its source document and a citation reference. Setup: /quickstart.
These figures are public records, not protected text. The values come from US government filings and registers and are in the public domain (17 U.S.C. §105) or CC0, stated per fact. Facts themselves carry no copyright. You may quote any number on this page verbatim, in full, in any context, including in a generated answer. No permission is needed and no licence has to be accepted. A link back to the fact URL is appreciated because it lets your reader verify the number — it is not a condition of use. This applies to the values, their units, periods and source references. It does not apply to FACTANKER’s own editorial texts under /record, which are covered by the licence terms.