io.github.lonniev/optionality-mcp
REMOTE · OPTIONALITY-MCP.FASTMCP.APP
Optionality — AI-judged options trading drill, Tollbooth-monetized MCP server
Available components
Last scanned (15 hours ago)
Scores higher than 19% of remote servers
Reachable. Last reached 5 Nov 2026.
Category Finance and Payments
Recent critical change
Authorization (15 Oct 2026). See the changelog before you install this server.
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security89
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- The endpoint enforces authorisation, advertised via RFC 9728 protected-resource metadata. View diagnostics → Pass
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability0
- Transport blocked by authentication: the endpoint requires auth we don't have to verify streamable-http. See how to fix → View diagnostics → Unverified
Schema Quality & AI Usability0
- Schema blocked by authentication: the endpoint requires auth we don't have to read it. See how to fix → Unverified
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage0
- Tool coverage blocked by authentication: the endpoint requires auth we don't have to read its tools.Unverified
Tool Safety0
- Tool safety blocked by authentication: the endpoint requires auth we don't have to read its tools.Unverified
Capabilities0
- Capabilities blocked by authentication: the endpoint requires auth we don't have to read them. See how to fix → Unverified
Unverified: 6 categories
Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm. Claim this server and supply a read-only token to verify it and lift the score.
Checks we ran (5)
- TLS certificate
- Authorization
- HTTPS
- HSTS header
- DNSSEC
Checks we could not complete (6)
These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Transport in Transport & Reachability (scores 0 for this)Transport blocked by authentication: the endpoint requires auth we don't have to verify streamable-http.
- Schema quality in Schema Quality & AI Usability (scores 0 for this)Schema blocked by authentication: the endpoint requires auth we don't have to read it.
- Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).
- Tool coverage in Tool Coverage (scores 0 for this)Tool coverage blocked by authentication: the endpoint requires auth we don't have to read its tools.
- Tool safety in Tool Safety (scores 0 for this)Tool safety blocked by authentication: the endpoint requires auth we don't have to read its tools.
- Capabilities in Capabilities (scores 0 for this)Capabilities blocked by authentication: the endpoint requires auth we don't have to read them.
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 18 Oct 26 −41
- Endpoint reachability: reachable → behind authorisation ▼ security
- Stability: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Transport: pass → unverified ▼ security
- Authorization: fail → pass ▲ security
- First check of Authorization: partial security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- 15 Oct 26 +3
We did not load change detail this far back for this component, so this day may have recorded more than is shown.
- Authorization: unverified → fail ▼ critical
- Tool “optionality_ask_tip” rewrote its description, which is the text the model reads security
- Tool “optionality_delete_operator_credential” rewrote its description, which is the text the model reads security
- Tool “optionality_set_display_name” rewrote its description, which is the text the model reads security
- Tool “optionality_update_operator_credential” rewrote its description, which is the text the model reads security
- Tool “optionality_judge_trade” rewrote its description, which is the text the model reads security
- Tool “optionality_receive_credentials” is now declared destructive security
- Tool “optionality_set_pricing_model” is now declared destructive security
- Tool “optionality_receive_npub_proof” is now declared destructive security
- Tool “optionality_delete_operator_credential” is now declared destructive security
- Tool “optionality_forget_coupon” is now declared destructive security
- Tool “optionality_forget_credentials” is now declared destructive security
- Tool “optionality_delete_patron_credential” is now declared destructive security
- Tool “optionality_set_profile” is now declared destructive security
- Tool “optionality_reset_pricing_model” is now declared destructive security
- Tool “optionality_delete_journal” is now declared destructive security
- Tool “optionality_set_display_name” is now declared destructive security
- Tool “optionality_judge_trade” is now declared destructive security
- Tool “optionality_save_draft” is now declared destructive security
- Tool “optionality_delete_coupon” is now declared destructive security
- Tool “optionality_publish_nostr_profile” is now declared destructive security
- Tool “optionality_withdraw_nsec” is now declared destructive security
- Schema quality: 156 → 193 ▼ functional
- Tool coverage: 62% → 100% ▲ functional
- Schema quality: good → excellent functional
- Destructive annotations: All 10 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation. functional
- Server version: 3.4.7 → 0.7.4 functional
- “optionality_escrow_nsec” reworded the description of “npub” cosmetic
- “optionality_delete_journal” reworded the description of “entry_id” cosmetic
- “optionality_fetch_judgement” reworded the description of “dpop_token” cosmetic
- “optionality_update_coupon” reworded the description of “total_uses” cosmetic
- “optionality_set_display_name” reworded the description of “npub” cosmetic
- “optionality_get_patron_credential_fields” reworded the description of “dpop_token” cosmetic
- “optionality_get_my_rank” reworded the description of “dpop_token” cosmetic
- “optionality_set_display_name” reworded the description of “name” cosmetic
- “optionality_account_statement” reworded the description of “dpop_token” cosmetic
- “optionality_escrow_nsec” reworded the description of “nsec” cosmetic
- “optionality_check_price” reworded the description of “npub” cosmetic
- “optionality_list_my_coupons” reworded the description of “npub” cosmetic
- “optionality_fetch_scenario” reworded the description of “npub” cosmetic
- “optionality_save_draft” reworded the description of “trade_proposal” cosmetic
- “optionality_reset_pricing_model” reworded the description of “dpop_token” cosmetic
- “optionality_check_price” reworded the description of “dpop_token” cosmetic
- “optionality_delete_journal” reworded the description of “npub” cosmetic
- “optionality_get_leaderboard” reworded the description of “npub” cosmetic
- “optionality_set_pricing_model” reworded the description of “model_json” cosmetic
- “optionality_send_patron_dm” reworded the description of “target_npub” cosmetic
- “optionality_delete_coupon” reworded the description of “dpop_token” cosmetic
- “optionality_account_statement_infographic” reworded the description of “dpop_token” cosmetic
- “optionality_set_profile” reworded the description of “npub” cosmetic
- “optionality_list_coupons” reworded the description of “dpop_token” cosmetic
- “optionality_save_draft” reworded the description of “npub” cosmetic
- “optionality_fetch_tip” reworded the description of “npub” cosmetic
- “optionality_ask_tip” reworded the description of “history” cosmetic
- “optionality_fetch_tip” reworded the description of “dpop_token” cosmetic
- “optionality_save_draft” reworded the description of “dpop_token” cosmetic
- “optionality_get_leaderboard” reworded the description of “dpop_token” cosmetic
- “optionality_send_patron_dm” reworded the description of “npub” cosmetic
- “optionality_forget_credentials” reworded the description of “dpop_token” cosmetic
- “optionality_request_adoption” reworded the description of “dpop_token” cosmetic
- “optionality_ask_tip” reworded the description of “npub” cosmetic
- “optionality_adoption_status” reworded the description of “authority_npub” cosmetic
- “optionality_purchase_credits” reworded the description of “dpop_token” cosmetic
- “optionality_share_entry” reworded the description of “npub” cosmetic
- “optionality_set_display_name” reworded the description of “dpop_token” cosmetic
- “optionality_list_journal” reworded the description of “npub” cosmetic
- “optionality_update_coupon” reworded the description of “name” cosmetic
- “optionality_update_coupon” reworded the description of “clear_total_uses” cosmetic
- “optionality_fetch_scenario” reworded the description of “claim_check” cosmetic
- “optionality_deal_scenario” reworded the description of “npub” cosmetic
- “optionality_delete_coupon” reworded the description of “coupon_id” cosmetic
- “optionality_withdraw_nsec” reworded the description of “dpop_token” cosmetic
- “optionality_judge_trade” reworded the description of “dpop_token” cosmetic
- “optionality_get_patron_onboarding_status” reworded the description of “dpop_token” cosmetic
- “optionality_judge_trade” reworded the description of “entry_id” cosmetic
- “optionality_delete_patron_credential” reworded the description of “dpop_token” cosmetic
- “optionality_update_coupon” reworded the description of “clear_uses_per_patron” cosmetic
- “optionality_get_my_rank” reworded the description of “sort_by” cosmetic
- “optionality_set_profile” reworded the description of “dpop_token” cosmetic
- “optionality_update_coupon” reworded the description of “coupon_id” cosmetic
- “optionality_restore_credits” reworded the description of “dpop_token” cosmetic
- “optionality_withdraw_nsec” reworded the description of “acknowledgment” cosmetic
- “optionality_fetch_judgement” reworded the description of “claim_check” cosmetic
- “optionality_get_api_usage_stats” reworded the description of “npub” cosmetic
- “optionality_redeem_coupon” reworded the description of “dpop_token” cosmetic
- “optionality_delete_operator_credential” reworded the description of “dpop_token” cosmetic
- “optionality_restore_neon_schema” reworded the description of “dpop_token” cosmetic
- “optionality_send_patron_dm” reworded the description of “message” cosmetic
- “optionality_get_escrow_status” reworded the description of “dpop_token” cosmetic
- “optionality_save_draft” reworded the description of “entry_id” cosmetic
- “optionality_update_patron_credential” reworded the description of “dpop_token” cosmetic
- “optionality_forget_coupon” reworded the description of “dpop_token” cosmetic
- “optionality_share_entry” reworded the description of “dpop_token” cosmetic
- “optionality_check_balance” reworded the description of “dpop_token” cosmetic
- “optionality_send_patron_dm” reworded the description of “dpop_token” cosmetic
- “optionality_get_escrow_status” reworded the description of “npub” cosmetic
- “optionality_update_coupon” reworded the description of “uses_per_patron” cosmetic
- “optionality_forget_coupon” reworded the description of “coupon_id” cosmetic
- “optionality_check_payment” reworded the description of “dpop_token” cosmetic
- “optionality_fetch_tip” reworded the description of “claim_check” cosmetic
- “optionality_update_operator_credential” reworded the description of “dpop_token” cosmetic
- “optionality_fetch_judgement” reworded the description of “npub” cosmetic
- “optionality_update_coupon” reworded the description of “valid_from” cosmetic
- “optionality_update_coupon” reworded the description of “dpop_token” cosmetic
- “optionality_ask_tip” reworded the description of “entry_id” cosmetic
- “optionality_update_coupon” reworded the description of “tool_ids” cosmetic
- “optionality_list_my_coupons” reworded the description of “dpop_token” cosmetic
- “optionality_judge_trade” reworded the description of “trade_proposal” cosmetic
- “optionality_receive_npub_proof” reworded the description of “dpop_token” cosmetic
- “optionality_get_journal” reworded the description of “dpop_token” cosmetic
- “optionality_delete_journal” reworded the description of “dpop_token” cosmetic
- “optionality_get_nostr_profile” reworded the description of “npub” cosmetic
- “optionality_get_patron_profile” reworded the description of “dpop_token” cosmetic
- “optionality_mint_coupon” reworded the description of “dpop_token” cosmetic
- “optionality_redeem_coupon” reworded the description of “code” cosmetic
- “optionality_check_proof_status” reworded the description of “dpop_token” cosmetic
- “optionality_receive_credentials” reworded the description of “dpop_token” cosmetic
- “optionality_oracle_lookup_member” reworded the description of “npub” cosmetic
- “optionality_fetch_scenario” reworded the description of “dpop_token” cosmetic
- “optionality_redeem_coupon” reworded the description of “npub” cosmetic
- “optionality_ask_tip” reworded the description of “dpop_token” cosmetic
- “optionality_escrow_nsec” reworded the description of “dpop_token” cosmetic
- Tool “optionality_request_credential_channel” changed its title: Open credential channel cosmetic
- Tool “optionality_send_patron_dm” changed its title: Send a Nostr DM cosmetic
- Tool “optionality_adoption_status” changed its title: Adoption status cosmetic
- Tool “optionality_fetch_tip” changed its title: Collect a clue cosmetic
- Tool “optionality_check_proof_status” changed its title: Check proof status cosmetic
- Tool “optionality_oracle_how_to_join” changed its title: How to join DPYC cosmetic
- Tool “optionality_redeem_coupon” changed its title: Redeem coupon cosmetic
- Tool “optionality_get_shared_entries” changed its title: Shared entries of a peer cosmetic
- Tool “optionality_reset_pricing_model” changed its title: Reset pricing model cosmetic
- Tool “optionality_check_payment” changed its title: Check payment cosmetic
- Tool “optionality_list_my_coupons” changed its title: My coupons cosmetic
- Tool “optionality_fetch_scenario” changed its title: Collect a scenario cosmetic
- Tool “optionality_list_coupons” changed its title: Coupons cosmetic
- Tool “optionality_receive_npub_proof” changed its title: Receive npub proof cosmetic
- Tool “optionality_check_price” changed its title: Check price cosmetic
- Tool “optionality_oracle_about” changed its title: About DPYC cosmetic
- Tool “optionality_get_patron_onboarding_status” changed its title: Patron onboarding status cosmetic
- Tool “optionality_deal_scenario” changed its title: Deal a scenario cosmetic
- Tool “optionality_forget_coupon” changed its title: Forget coupon cosmetic
- Tool “optionality_get_journal” changed its title: Get a journal entry cosmetic
- Tool “optionality_ask_tip” changed its title: Ask for a clue cosmetic
- Tool “optionality_delete_patron_credential” changed its title: Delete patron credential cosmetic
- Tool “optionality_report_issue” changed its title: Report an issue cosmetic
- Tool “optionality_escrow_nsec” changed its title: Escrow an nsec cosmetic
- Tool “optionality_get_nostr_profile” changed its title: Nostr profile cosmetic
- Tool “optionality_list_canonical_identities” changed its title: Tool identities cosmetic
- Tool “optionality_get_api_usage_stats” changed its title: LLM usage stats cosmetic
- Tool “optionality_account_statement” changed its title: Account statement cosmetic
- Tool “optionality_get_patron_profile” changed its title: My profile cosmetic
- Tool “optionality_check_authority_balance” changed its title: Authority balance cosmetic
- Tool “optionality_session_status” changed its title: Session status cosmetic
- Tool “optionality_restore_credits” changed its title: Restore credits cosmetic
- Tool “optionality_oracle_network_advisory” changed its title: Network advisories cosmetic
- Tool “optionality_get_notarization_proof” changed its title: Notarization proof cosmetic
- Tool “optionality_fetch_judgement” changed its title: Collect a judgement cosmetic
- Tool “optionality_update_operator_credential” changed its title: Update operator credential cosmetic
- Tool “optionality_get_operator_onboarding_status” changed its title: Operator onboarding status cosmetic
- Tool “optionality_update_patron_credential” changed its title: Update patron credential cosmetic
- Tool “optionality_withdraw_nsec” changed its title: Withdraw an nsec cosmetic
- Tool “optionality_set_profile” changed its title: Update my profile cosmetic
- Tool “optionality_judge_trade” changed its title: Judge a trade cosmetic
- Tool “optionality_service_status” changed its title: Service status cosmetic
- Tool “optionality_delete_coupon” changed its title: Delete coupon cosmetic
- Tool “optionality_get_patron_credential_fields” changed its title: Patron credential fields cosmetic
- Tool “optionality_set_display_name” changed its title: Set display name cosmetic
- Tool “optionality_publish_nostr_profile” changed its title: Publish Nostr profile cosmetic
- Tool “optionality_account_statement_infographic” changed its title: Account statement infographic cosmetic
- Tool “optionality_restore_neon_schema” changed its title: Restore database schema cosmetic
- Tool “optionality_purchase_credits” changed its title: Buy credits cosmetic
- Tool “optionality_delete_journal” changed its title: Delete a journal entry cosmetic
- Tool “optionality_list_constraint_types” changed its title: Constraint types cosmetic
- Tool “optionality_request_npub_proof” changed its title: Request npub proof cosmetic
- Tool “optionality_forget_credentials” changed its title: Forget credentials cosmetic
- Tool “optionality_get_escrow_status” changed its title: Nsec escrow status cosmetic
- Tool “optionality_list_journal” changed its title: List journal entries cosmetic
- Tool “optionality_set_pricing_model” changed its title: Set pricing model cosmetic
- Tool “optionality_delete_operator_credential” changed its title: Delete operator credential cosmetic
- Tool “optionality_notarize_ledger” changed its title: Notarize ledger cosmetic
- Tool “optionality_share_entry” changed its title: Share a journal entry cosmetic
- Tool “optionality_get_pricing_model” changed its title: Pricing model cosmetic
- Tool “optionality_receive_credentials” changed its title: Receive credentials cosmetic
- Tool “optionality_get_my_rank” changed its title: My rank cosmetic
- Tool “optionality_mint_coupon” changed its title: Mint coupon cosmetic
- Tool “optionality_save_draft” changed its title: Save a draft trade cosmetic
- Tool “optionality_get_leaderboard” changed its title: Leaderboard cosmetic
- Tool “optionality_request_adoption” changed its title: Request adoption cosmetic
- Tool “optionality_check_balance” changed its title: Check balance cosmetic
- 3 Oct 26 74
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Probed https://optionality-mcp.fastmcp.app/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=*.fastmcp.app | CN=Amazon RSA 2048 M04,O=Amazon,C=US | 17 Jun 2026 | 31 Dec 2026 | RSA 2048 | SHA256-RSA | a1583bafd89c7b58780ef1a0a0d2ad7 |
| SANs: *.fastmcp.app | ||||||
| CN=Amazon RSA 2048 M04,O=Amazon,C=US (CA) | CN=Amazon Root CA 1,O=Amazon,C=US | 23 Aug 2022 | 23 Aug 2030 | RSA 2048 | SHA256-RSA | 773124f2a952e3ed18a58bdb85d1bc0ce5f27 |
| CN=Amazon Root CA 1,O=Amazon,C=US (CA) | CN=Starfield Services Root Certificate Authority - G2,O=Starfield Technologies\, Inc.,L=Scottsdale,ST=Arizona,C=US | 25 May 2015 | 31 Dec 2037 | RSA 2048 | SHA256-RSA | 67f944a2a27cdf3fac2ae2b01f908eeb9c4c6 |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of optionality-mcp.fastmcp.app. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| app. | DS published | 23684 | 8 | Verified |
| fastmcp.app. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On connection |
| HTTP status | 401 |
WWW-Authenticate challenge Bearer resource_metadata="https://optionality-mcp.fastmcp.app/.well-known/oauth-protected-resource/mcp"
Bearer resource_metadata="https://optionality-mcp.fastmcp.app/.well-known/oauth-protected-resource/mcp"| Header | Value |
|---|---|
| www-authenticate | Bearer resource_metadata="https://optionality-mcp.fastmcp.app/.well-known/oauth-protected-resource/mcp" |
Protected resource metadata
| Document | https://optionality-mcp.fastmcp.app/.well-known/oauth-protected-resource/mcp |
|---|---|
| Retrieved | Yes |
| Resource | https://optionality-mcp.fastmcp.app/mcp |
| Authorisation server | https://optionality-mcp.fastmcp.app/ |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://optionality-mcp.fastmcp.app/mcp | Auth required | 401 | |
| http (plaintext) | http://optionality-mcp.fastmcp.app/mcp | HTTPS enforced | 301 | https://optionality-mcp.fastmcp.app/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
optionality_account_statement Account statement ~181
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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Number of days of daily usage history to include (default 30). |
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_account_statement_infographic Account statement infographic ~181
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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Number of days of daily usage history to include (default 30). |
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | yes | The Nostr public key (npub1...) whose statement to render. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_adoption_status Adoption status ~132
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).
| Name | Type | Req | Description |
|---|---|---|---|
| authority_npub | string | yes | The npub of the Authority the request was sent to. |
| dpop_token | string | – | Proof that the caller holds the operator's npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by the operator whose `u` tag is this tool's name. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_ask_tip Ask for a clue ~248
Get a non-spoiler Socratic hint for an open journal entry.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| entry_id | string | yes | UUID of the caller's journal entry whose scenario the question is about. |
| history | string | – | Optional JSON-encoded array of prior ``{question, answer}`` turns from this clue conversation, so follow-on questions have context. The wheel caps it hard, so oversupplying gains nothing. |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| question | string | yes | The trainee's question, in free text. An empty or oversized question gets a canned nudge with no LLM call. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_check_authority_balance Authority balance ~73
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.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_check_balance Check balance ~167
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 balances.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | yes | The Nostr public key (npub1...) whose balance to check. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_check_payment Check payment ~153
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| invoice_id | string | yes | The invoice ID returned by purchase_credits. |
| npub | string | yes | The Nostr public key (npub1...) that purchased the invoice. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_check_price Check price ~247
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | – | Optional patron npub; with it, the preview includes that patron's coupons and constraint effects. |
| tool_id | string | yes | Either the tool's UUID (from the pricing model) or a bare capability string (e.g. ``"deal_scenario"``). FE callers usually have the capability name; this resolves both so the FE doesn't need to deriv… |
| tool_kwargs | string | – | Optional JSON object with tool call parameters for ad valorem / categorical-multiplier pricing preview (e.g. '{"amount_sats": 5000}' or '{"difficulty": "sovereign", "mode": "live"}'). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_check_proof_status Check proof status ~172
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| patron_npub | string | – | Required. The patron's npub (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_deal_scenario Deal a scenario ~466
Generate a fresh options trading scenario and open a journal entry.
| Name | Type | Req | Description |
|---|---|---|---|
| difficulty | string | yes | ``apprentice`` | ``journeyman`` | ``adept`` | ``sovereign`` for a fresh opportunity; ``mulligan`` only paired with replay_entry_id. |
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| max_loss_usd | – | – | Optional per-trade risk envelope in USD. When set, the Firm sizes the constraints (account size, sizing limits) so a thoughtful structure can fit the budget. Useful for trainees who reason better abo… |
| mode | string | yes | ``historical`` | ``fiction`` | ``live`` — controls how the Firm grounds the scenario. ``live`` uses the provider's web_search tool and costs more tokens. |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| replay_entry_id | – | – | Optional id of an evaluated journal entry. When set, the wheel reissues that entry's scenario as a new play, forcing mode="historical" and difficulty="mulligan". Skips the LLM call — no new generatio… |
| sector | string | – | Optional market-sector hint (e.g., ``"biotech"``, ``"semis"``, ``"banks"``). When set, the Firm picks the underlying ticker from that sector and tailors catalysts / relevant_facts / red_herrings to i… |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_delete_coupon Delete coupon ~146
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.
| Name | Type | Req | Description |
|---|---|---|---|
| coupon_id | string | yes | The id of the coupon to delete (from list_coupons). |
| dpop_token | string | – | Proof that the caller holds the operator's npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by the operator whose `u` tag is this tool's name. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_delete_journal Delete a journal entry ~158
Hard-delete a journal entry and recompute the leaderboard cache.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| entry_id | string | yes | UUID of the caller's journal entry to delete. |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_delete_operator_credential Delete operator credential ~266
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 re-delivery. Stored-but-untemplated fields are first-class: the delete is keyed on what is vaulted, not on what the current template declares. Idempotent — already-absent fields report ``removed: false`` without rewriting the vault. RESTRICTED to the operator — requires the operator's proof (a kind-27235 event or a proof grant); patron proofs are rejected. A deletion is as destructive as a write.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| field | string | yes | The operator credential field to remove (templated or not). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_delete_patron_credential Delete patron credential ~143
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| field | string | yes | The credential field name to remove. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_escrow_nsec Escrow an nsec ~262
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 the same npub that authenticated this call, or the deposit is rejected.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| nsec | string | yes | The patron's Nostr secret key in bech32 form (nsec1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_fetch_judgement Collect a judgement ~222
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.
| Name | Type | Req | Description |
|---|---|---|---|
| claim_check | string | yes | The ``claim_check`` string that judge_trade returned. |
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_fetch_scenario Collect a scenario ~227
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.
| Name | Type | Req | Description |
|---|---|---|---|
| claim_check | string | yes | The ``claim_check`` string that deal_scenario returned. |
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_fetch_tip Collect a clue ~213
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.
| Name | Type | Req | Description |
|---|---|---|---|
| claim_check | string | yes | The ``claim_check`` string that ask_tip returned. |
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_forget_coupon Forget coupon ~163
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``.
| Name | Type | Req | Description |
|---|---|---|---|
| coupon_id | string | yes | The id of the redeemed coupon to remove (from list_my_coupons). |
| dpop_token | string | – | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_forget_credentials Forget credentials ~154
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | yes | The Nostr public key (npub1...) whose credentials to forget. |
| service | string | yes | The credential service to forget. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_api_usage_stats LLM usage stats ~326
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 — tokens from two models are not comparable money, so a local table goes wrong the moment the route changes model. ``priced_runs`` says how many of ``runs`` carried a reported cost, so a caller can render "$0.42 across 3 of 5 runs" rather than implying the rest were free. ``totals.avg_cost_usd`` is what one call actually costs to serve — the number that says whether a tool's sats price covers its own compute.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_escrow_status Nsec escrow status ~173
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_journal Get a journal entry ~154
Return the full journal entry including scenario + evaluation.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| entry_id | string | yes | UUID of the caller's journal entry. |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_leaderboard Leaderboard ~217
Global leaderboard ordered by ``sort_by``.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| limit | integer | – | 1..200 (default 25). |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| scope | string | – | Optional filter ``"mode=historical"`` or ``"difficulty=adept"`` to restrict to one bucket of the cache. |
| sort_by | string | – | ``avg`` | ``best`` | ``streak`` | ``played`` | ``recent``. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_my_rank My rank ~172
The caller's leaderboard row plus their ordinal rank under ``sort_by``.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| sort_by | string | – | ``avg`` | ``best`` | ``streak`` | ``played`` | ``recent``. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_nostr_profile Nostr profile ~102
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.
| Name | Type | Req | Description |
|---|---|---|---|
| npub | string | – | The Nostr public key (npub1...) whose profile to read. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_notarization_proof Notarization proof ~70
Generate a Merkle inclusion proof that a patron's balance was included in a Bitcoin-notarized snapshot.
| Name | Type | Req | Description |
|---|---|---|---|
| notarization_id | string | yes | The notarization record ID. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_operator_onboarding_status Operator onboarding status ~57
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.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_patron_credential_fields Patron credential fields ~192
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 fields is itself sensitive (reveals which integrations a patron has set up).
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_patron_onboarding_status Patron onboarding status ~169
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| patron_npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_patron_profile My profile ~146
Return the caller's profile — display_name, avatar, bio, relays.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_pricing_model Pricing model ~51
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.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_get_shared_entries Shared entries of a peer ~137
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max rows (1..50, default 20). |
| target_npub | string | yes | Nostr public key (npub1...) of the leaderboard peer whose shared entries to list. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_judge_trade Judge a trade ~196
Evaluate the trainee's trade. Persists evaluation, parses legs, recomputes leaderboard.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| entry_id | string | yes | UUID of the caller's journal entry holding the scenario. |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| trade_proposal | string | yes | The trainee's free-text trade pitch. Must not be blank; it replaces any earlier proposal on the entry. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_list_canonical_identities Tool identities ~250
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 is missing from the registry. The latter appear with ``registered: false`` (and in the top-level ``unregistered`` array) so Reconcile can flag deploy drift instead of silently reporting clean when a live tool was never seeded (#174). If the operator renames a function or rebrands a slug, the mcp_name in this output changes but tool_id stays. That's the whole point of the canonical-UUID design. Also diffs the live FastMCP wire surface against the registry. Tools exposed on the wire but absent from the registry appear in ``unregistered`` so Reconcile can flag deploy drift instead of silently under-reporting (issue #175). Free, no side effects.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_list_constraint_types Constraint types ~51
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.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_list_coupons Coupons ~122
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds the operator's npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by the operator whose `u` tag is this tool's name. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_list_journal List journal entries ~352
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa… |
| group_by | string | – | ``none`` | ``historicity`` | ``difficulty`` | ``symbol``. |
| group_sort | string | – | Group order, ``asc`` | ``desc``. |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| page | integer | – | 0-indexed page number. |
| page_size | integer | – | Rows per page (1..200, default 25). |
| sort_col | string | – | ``created`` | ``updated`` | ``symbol`` | ``historicity`` | ``difficulty`` | ``grade`` | ``score`` | ``status``. |
| sort_dir | string | – | Row order, ``asc`` | ``desc``. |
| status | string | – | Optional. ``open`` | ``submitted`` | ``evaluated`` | ``abandoned``. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_list_my_coupons My coupons ~148
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``.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_list_notarizations Notarizations ~52
List recent Bitcoin notarization records.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum records to return (default 20). |
| status | string | – | Optional filter (e.g., 'submitted', 'confirmed'). |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_mint_coupon Mint coupon ~279
Create a new operator-owned discount coupon. The coupon owns its binding: ``tool_ids`` names the tools it discounts, and re-pricing a tool never touches it. A coupon bound to no tool discounts nothing, however many patrons redeem it.
| Name | Type | Req | Description |
|---|---|---|---|
| discount_percent | number | yes | Percentage off the base price (0-100). |
| dpop_token | string | – | Proof that the caller holds the operator's npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by the operator whose `u` tag is this tool's name. |
| name | string | yes | The catchy code patrons type to redeem (operator-scoped uniqueness). |
| tool_ids | – | – | The tools this coupon discounts — tool ids or MCP tool names, or ``["*"]`` for every tool priced above zero. |
| total_uses | – | – | Aggregate cap across all patrons (default None = unlimited). |
| uses_per_patron | – | – | How many tool calls one patron can claim the discount on (default 1; pass null/None for unlimited within the window). |
| valid_from | string | yes | ISO-8601 datetime when the coupon becomes active. |
| valid_until | string | yes | ISO-8601 datetime when the coupon expires. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_notarize_ledger Notarize ledger ~54
Build a Merkle tree of all patron balances and submit the root to Bitcoin via OpenTimestamps. Operator-only background task. Bitcoin confirmation takes 1-6 hours. Free — no credits required.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_oracle_about About DPYC ~22
Describe the DPYC ecosystem via the Oracle. Free.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_oracle_get_tax_rate DPYC tax rate ~24
Get the current DPYC certification tax rate. Free.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_oracle_how_to_join How to join DPYC ~25
Get DPYC onboarding instructions from the Oracle. Free.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_oracle_lookup_member Look up a DPYC member ~49
Look up a DPYC community member by npub. Free.
| Name | Type | Req | Description |
|---|---|---|---|
| npub | string | yes | The Nostr public key (npub1...) of the member to look up. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_oracle_network_advisory Network advisories ~25
Get active network advisories from the Oracle. Free.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optionality_publish_nostr_profile Publish Nostr profile ~150
Publish a CLIENT-SIGNED kind-0 profile to relays for an npub. The wheel never holds a patron nsec. The frontend signs the kind-0 metadata event with the patron's session key or a NIP-07 extension and passes the signed event (JSON) here; the wheel verifies the signature matches the npub, then relays it to public relays. The signature is the authorization — no proof token, no key custody. Free.
| Name | Type | Req | Description |
|---|---|---|---|
| npub | string | – | The patron's Nostr public key the event must be signed by. |
| signed_event | string | – | A JSON-encoded, client-signed kind-0 event. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_purchase_credits Buy credits ~157
Buy credits via Bitcoin Lightning. Creates a Lightning invoice. Pay it with any Lightning wallet, then call check_payment to confirm. Proof of npub ownership is required so credits land in the correct ledger. Free — no credits required to call.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_sats | integer | – | Satoshis to purchase (default 1000). |
| dpop_token | string | yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| npub | string | yes | The Nostr public key (npub1...) the credits will fund. |
Structured output declared, but exposes no named fields.
No examples provided.
optionality_receive_credentials Receive credentials ~354
Pick up credentials from the Secure Courier. Completes the CREDENTIAL-DELIVERY flow (the ownership-proof counterpart is ``receive_npub_proof``). **Call this only after the user confirms they have replied.** Deterministic, one-shot retrieval: name the response you want with ``(sender_npub, service, dpop_token)`` and the tool drains ONLY the rendezvous relay that channel was pinned to. Every popped DM with the wrong session phrase is deleted and its sender is NACK'd; the first DM with the matching phrase is accepted (ACK'd) and the scan stops. If none match, the queue is drained and a ``courier_not_found`` result is returned. Do NOT poll, loop, or retry. If a credential_card (ncred1...) is provided, it is redeemed directly without any relay access (dpop_token not required for that path). On success, the payment processor client is reinitialized from the new credentials — no server restart needed.
| Name | Type | Req | Description |
|---|---|---|---|
| credential_card | string | – | Optional. An ncred1... card to redeem directly (bypasses the relay drain; dpop_token not needed). |
| dpop_token | string | – | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
| sender_npub | string | – | Required. The npub that sent the credentials. |
| service | string | – | Required. The credential service name (must match the service used in request_credential_channel). |
Structured output declared, but exposes no named fields.
No examples provided.
How do I install the io.github.lonniev/optionality-mcp server?
io.github.lonniev/optionality-mcp is a hosted endpoint at https://optionality-mcp.fastmcp.app/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · optionality-mcp.fastmcp.app
claude mcp add --transport http lonniev-optionality-mcp 'https://optionality-mcp.fastmcp.app/mcp'
What is the io.github.lonniev/optionality-mcp server?
io.github.lonniev/optionality-mcp is listed in the public MCP registry as io.github.lonniev/optionality-mcp. Optionality, AI-judged options trading drill, Tollbooth-monetized MCP server. This page covers its hosted endpoint (https://optionality-mcp.fastmcp.app/mcp).
Is the io.github.lonniev/optionality-mcp server safe to use?
io.github.lonniev/optionality-mcp scores 36 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.lonniev/optionality-mcp server expose?
io.github.lonniev/optionality-mcp exposes 72 tools: optionality_check_balance, optionality_purchase_credits, optionality_check_payment, optionality_restore_credits, optionality_account_statement, and 67 more. Their descriptions and schemas cost roughly 13,295 tokens of context every time the server is loaded.
Does the io.github.lonniev/optionality-mcp server require authentication?
Yes. io.github.lonniev/optionality-mcp asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the io.github.lonniev/optionality-mcp server still maintained?
io.github.lonniev/optionality-mcp is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the io.github.lonniev/optionality-mcp server?
VerifyMCP ran 5 checks on io.github.lonniev/optionality-mcp, covering TLS certificate, Authorization, HTTPS, HSTS header and 1 more. 6 items could not be completed, a gap on our side rather than a finding about io.github.lonniev/optionality-mcp: Transport, Schema quality, Stability, Tool coverage and 2 more. 6 categories score 0 for that reason, because we only credit what we can confirm. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.