Skip to main content
Glama

Reading Nansen feedback preferences

get_feedback_preferences
Read-onlyIdempotent

Read the authenticated account's saved automatic feedback preference. Free; no report quota.

Before a new automatic report about useful Nansen friction, draft a concise report without secrets or unnecessary conversation details and call this tool. Enabled permits sending subject to host and local-deny controls and account rollout. If off, unconfigured or unavailable, show the report and ask first. Refusal, host denial or inability to ask means no submission. An explicit request or approval permits only that report. Never enable the preference automatically. Direct lasting changes to Superapp settings. Reads are fresh, use this account only, and do not authorize another account or server key.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "request": "<request>"
    },
    "name": "get_feedback_preferences"
  }
}

Input Schema

NameRequiredDescriptionDefault
requestYesEmpty object. Reads the feedback preference for the authenticated account.

Output Schema

NameRequiredDescriptionDefault
errorNo
receiptNo
successYes
next_actionYes
preferencesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / request / description
      Added value: +"Empty object. Reads the feedback preference for the authenticated account."
  2. Changed1 schema field changed
    • changedOutput schema / properties / error / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "code": {
      -        "title": "Code",
      -        "type": "string"
      -      },
      -      "quota": {
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "limit": {
      -                "const": 7,
      -                "title": "Limit",
      -                "type": "integer"
      -              },
      -              "remaining": {
      -                "maximum": 7,
      -                "minimum": 0,
      -                "title": "Remaining",
      -                "type": "integer"
      -              },
      -              "resets_at": {
      -                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$",
      -                "title": "Resets At",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "limit",
      -              "remaining",
      -              "resets_at"
      -            ],
      -            "title": "FeedbackQuota",
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null
      -      },
      -      "reason": {
      -        "title": "Reason",
      -        "type": "string"
      -      },
      -      "request_id": {
      -        "anyOf": [
      -          {
      -            "maxLength": 128,
      -            "minLength": 1,
      -            "pattern": "^[A-Za-z0-9_-]+$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "title": "Request Id"
      -      },
      -      "retry_after": {
      -        "anyOf": [
      -          {
      -            "minimum": 0,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "title": "Retry After"
      -      },
      -      "status": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "title": "Status"
      -      },
      -      "submission_id": {
      -        "anyOf": [
      -          {
      -            "maxLength": 128,
      -            "minLength": 1,
      -            "pattern": "^[A-Za-z0-9_-]+$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "title": "Submission Id"
      -      }
      -    },
      -    "required": [
      -      "code",
      -      "reason"
      -    ],
      -    "title": "FeedbackError",
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "code": {
      +        "title": "Code",
      +        "type": "string"
      +      },
      +      "errors": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "description": "One field that failed validation. It never contains the field value.",
      +              "properties": {
      +                "code": {
      +                  "title": "Code",
      +                  "type": "string"
      +                },
      +                "field": {
      +                  "title": "Field",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "field",
      +                "code"
      +              ],
      +              "title": "FeedbackFieldError",
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Errors"
      +      },
      +      "quota": {
      +        "anyOf": [
      +          {
      +            "properties": {
      +              "limit": {
      +                "const": 7,
      +                "title": "Limit",
      +                "type": "integer"
      +              },
      +              "remaining": {
      +                "maximum": 7,
      +                "minimum": 0,
      +                "title": "Remaining",
      +                "type": "integer"
      +              },
      +              "resets_at": {
      +                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$",
      +                "title": "Resets At",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "limit",
      +              "remaining",
      +              "resets_at"
      +            ],
      +            "title": "FeedbackQuota",
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null
      +      },
      +      "reason": {
      +        "title": "Reason",
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "anyOf": [
      +          {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "pattern": "^[A-Za-z0-9_-]+$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Request Id"
      +      },
      +      "retry_after": {
      +        "anyOf": [
      +          {
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Retry After"
      +      },
      +      "status": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Status"
      +      },
      +      "submission_id": {
      +        "anyOf": [
      +          {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "pattern": "^[A-Za-z0-9_-]+$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Submission Id"
      +      }
      +    },
      +    "required": [
      +      "code",
      +      "reason"
      +    ],
      +    "title": "FeedbackError",
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. Added

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds genuinely non-obvious context: no quota cost, reads are fresh, the read is scoped to this account and does not authorize another account or server key, and absence of the preference must be treated as 'ask first' rather than permission. A minor deduction for the ambiguous Superapp-settings sentence.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and cost are front-loaded, which is good, but the body is a dense block of run-on conditional clauses and comma-spliced fragments ('Refusal, host denial or inability to ask means no submission') that take effort to parse. Several sentences could be tightened or split without losing meaning, and 'Direct lasting changes to Superapp settings' reads as a stray note with unclear relation to the rest.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, and the description covers the remaining gaps: account scoping, freshness, cost, the consent protocol, and what to do for each preference state. For a one-parameter read tool, an agent has everything needed to call it and act on the result correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is a single required parameter that is an explicitly empty object, and the schema documents it at 100% coverage with additionalProperties false, so there is no ambiguity to resolve. The description correctly adds nothing about parameter shape and instead spends its words on account scoping, which is the only meaningful semantic constraint here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence gives a specific verb and resource: reads the authenticated account's saved automatic feedback preference, plus a cost note (free, no report quota). That clearly separates it from submit_feedback and get_feedback, though it never names a sibling or states the contrast explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives an explicit trigger ('before a new automatic report about useful Nansen friction') and clear branch handling for every preference state: enabled permits sending subject to host/local-deny controls, while off/unconfigured/unavailable means show the report and ask first. Refusal or inability to ask means no submission, and it forbids enabling the preference automatically. It stops short of naming alternative tools, and the fragment 'Direct lasting changes to Superapp settings' is vague about where those changes should go.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources