Skip to main content
Glama

Assinafy MCP Server

Browse contracts

assinafy_browse_contracts
Read-onlyIdempotent

Find contracts with action list and filters, read terms or an amendment with get, or read the root and its amendments with related. Resolve names before writes. Apps-capable hosts show a contract browser; other clients receive the same JSON. Contract lifecycle dates are separate from signing deadlines. Reads remain available when the tracking plan lapses.

Input Schema

NameRequiredDescriptionDefault
pageNoPage number.
sortNo`end_date` or `updated_at`; prefix with `-` for descending (`-updated_at`, the default). Contracts without an end date come last either way.
actionYes
expandNo`document` embeds each contract's document.
searchNoPart of the document's name.
statusNoContract status; several, comma-separated, match any of them.
per_pageNoRecords per page (API caps at 50).
account_idNo
document_idNo
end_date_toNoContracts ending on or before this date.
external_idNoID of an external reference in that system.
counterpartyNoPart of the counterparty name.
end_date_fromNoContracts ending on or after this date.
external_systemNoSystem of an external reference, e.g. `hubspot`.
ending_within_daysNoContracts ending from today (the API's calendar day, Brasília time) to that many days later, both included; `0` is today. Any status: add `status=active` for the ones still in force.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "account_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "action": {
      -        "const": "list",
      -        "type": "string"
      -      },
      -      "counterparty": {
      -        "description": "Part of the counterparty name, or its exact CPF/CNPJ.",
      -        "type": "string"
      -      },
      -      "end_date_from": {
      -        "description": "Contracts ending on or after this date.",
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "end_date_to": {
      -        "description": "Contracts ending on or before this date.",
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "ending_within_days": {
      -        "description": "Contracts ending from today (the API's calendar day, Brasília time) to that many days later, both included; `0` is today. Any status: add `status=active` for the ones still in force.",
      -        "maximum": 3650,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "expand": {
      -        "description": "`document` embeds each contract's document.",
      -        "enum": [
      -          "document"
      -        ],
      -        "type": "string"
      -      },
      -      "external_id": {
      -        "description": "ID of an external reference in that system.",
      -        "type": "string"
      -      },
      -      "external_system": {
      -        "description": "System of an external reference, e.g. `hubspot`.",
      -        "type": "string"
      -      },
      -      "page": {
      -        "description": "Page number.",
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "per_page": {
      -        "description": "Records per page (API caps at 50).",
      -        "maximum": 100,
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "search": {
      -        "description": "Part of the document's name.",
      -        "type": "string"
      -      },
      -      "sort": {
      -        "description": "`end_date` or `updated_at`; prefix with `-` for descending (`-updated_at`, the default). Contracts without an end date come last either way.",
      -        "enum": [
      -          "end_date",
      -          "-end_date",
      -          "updated_at",
      -          "-updated_at"
      -        ],
      -        "type": "string"
      -      },
      -      "status": {
      -        "description": "Contract status; several, comma-separated, match any of them.",
      -        "pattern": "^(draft|active|expired|terminated)(,(draft|active|expired|terminated))*$",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "account_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "action": {
      -        "const": "get",
      -        "type": "string"
      -      },
      -      "document_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "document_id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "account_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "action": {
      -        "const": "related",
      -        "type": "string"
      -      },
      -      "document_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "document_id"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "account_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "action": {
      +        "const": "list",
      +        "type": "string"
      +      },
      +      "counterparty": {
      +        "description": "Part of the counterparty name.",
      +        "type": "string"
      +      },
      +      "end_date_from": {
      +        "description": "Contracts ending on or after this date.",
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "end_date_to": {
      +        "description": "Contracts ending on or before this date.",
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "ending_within_days": {
      +        "description": "Contracts ending from today (the API's calendar day, Brasília time) to that many days later, both included; `0` is today. Any status: add `status=active` for the ones still in force.",
      +        "maximum": 3650,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "expand": {
      +        "description": "`document` embeds each contract's document.",
      +        "enum": [
      +          "document"
      +        ],
      +        "type": "string"
      +      },
      +      "external_id": {
      +        "description": "ID of an external reference in that system.",
      +        "type": "string"
      +      },
      +      "external_system": {
      +        "description": "System of an external reference, e.g. `hubspot`.",
      +        "type": "string"
      +      },
      +      "page": {
      +        "description": "Page number.",
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "per_page": {
      +        "description": "Records per page (API caps at 50).",
      +        "maximum": 100,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "search": {
      +        "description": "Part of the document's name.",
      +        "type": "string"
      +      },
      +      "sort": {
      +        "description": "`end_date` or `updated_at`; prefix with `-` for descending (`-updated_at`, the default). Contracts without an end date come last either way.",
      +        "enum": [
      +          "end_date",
      +          "-end_date",
      +          "updated_at",
      +          "-updated_at"
      +        ],
      +        "type": "string"
      +      },
      +      "status": {
      +        "description": "Contract status; several, comma-separated, match any of them.",
      +        "pattern": "^(draft|active|expired|terminated)(,(draft|active|expired|terminated))*$",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "account_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "action": {
      +        "const": "get",
      +        "type": "string"
      +      },
      +      "document_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "document_id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "account_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "action": {
      +        "const": "related",
      +        "type": "string"
      +      },
      +      "document_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "document_id"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / counterparty / description
      Previous value: -"Part of the counterparty name, or its exact CPF/CNPJ."New value: +"Part of the counterparty name."
  2. Changed2 schema fields changed
    • changedInput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "account_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "action": {
      -        "const": "list",
      -        "type": "string"
      -      },
      -      "counterparty": {
      -        "description": "Part of the counterparty name, or its exact CPF/CNPJ.",
      -        "type": "string"
      -      },
      -      "end_date_from": {
      -        "description": "Contracts ending on or after this date.",
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "end_date_to": {
      -        "description": "Contracts ending on or before this date.",
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "ending_within_days": {
      -        "description": "Contracts ending from today (the API's calendar day, Brasília time) to that many days later, both included; `0` is today. Any status: add `status=active` for the ones still in force.",
      -        "maximum": 3650,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "expand": {
      -        "description": "`document` embeds each contract's document.",
      -        "enum": [
      -          "document"
      -        ],
      -        "type": "string"
      -      },
      -      "external_id": {
      -        "description": "ID of an external reference in that system.",
      -        "type": "string"
      -      },
      -      "external_system": {
      -        "description": "System of an external reference, e.g. `hubspot`.",
      -        "type": "string"
      -      },
      -      "page": {
      -        "description": "Page number.",
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "per_page": {
      -        "description": "Records per page (max 100).",
      -        "maximum": 100,
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "search": {
      -        "description": "Part of the document's name.",
      -        "type": "string"
      -      },
      -      "sort": {
      -        "description": "`end_date` or `updated_at`; prefix with `-` for descending (`-updated_at`, the default). Contracts without an end date come last either way.",
      -        "enum": [
      -          "end_date",
      -          "-end_date",
      -          "updated_at",
      -          "-updated_at"
      -        ],
      -        "type": "string"
      -      },
      -      "status": {
      -        "description": "Contract status; several, comma-separated, match any of them.",
      -        "pattern": "^(draft|active|expired|terminated)(,(draft|active|expired|terminated))*$",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "account_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "action": {
      -        "const": "get",
      -        "type": "string"
      -      },
      -      "document_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "document_id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "account_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "action": {
      -        "const": "related",
      -        "type": "string"
      -      },
      -      "document_id": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "document_id"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "account_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "action": {
      +        "const": "list",
      +        "type": "string"
      +      },
      +      "counterparty": {
      +        "description": "Part of the counterparty name, or its exact CPF/CNPJ.",
      +        "type": "string"
      +      },
      +      "end_date_from": {
      +        "description": "Contracts ending on or after this date.",
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "end_date_to": {
      +        "description": "Contracts ending on or before this date.",
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "ending_within_days": {
      +        "description": "Contracts ending from today (the API's calendar day, Brasília time) to that many days later, both included; `0` is today. Any status: add `status=active` for the ones still in force.",
      +        "maximum": 3650,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "expand": {
      +        "description": "`document` embeds each contract's document.",
      +        "enum": [
      +          "document"
      +        ],
      +        "type": "string"
      +      },
      +      "external_id": {
      +        "description": "ID of an external reference in that system.",
      +        "type": "string"
      +      },
      +      "external_system": {
      +        "description": "System of an external reference, e.g. `hubspot`.",
      +        "type": "string"
      +      },
      +      "page": {
      +        "description": "Page number.",
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "per_page": {
      +        "description": "Records per page (API caps at 50).",
      +        "maximum": 100,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "search": {
      +        "description": "Part of the document's name.",
      +        "type": "string"
      +      },
      +      "sort": {
      +        "description": "`end_date` or `updated_at`; prefix with `-` for descending (`-updated_at`, the default). Contracts without an end date come last either way.",
      +        "enum": [
      +          "end_date",
      +          "-end_date",
      +          "updated_at",
      +          "-updated_at"
      +        ],
      +        "type": "string"
      +      },
      +      "status": {
      +        "description": "Contract status; several, comma-separated, match any of them.",
      +        "pattern": "^(draft|active|expired|terminated)(,(draft|active|expired|terminated))*$",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "account_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "action": {
      +        "const": "get",
      +        "type": "string"
      +      },
      +      "document_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "document_id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "account_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "action": {
      +        "const": "related",
      +        "type": "string"
      +      },
      +      "document_id": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "document_id"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / per_page / description
      Previous value: -"Records per page (max 100)."New value: +"Records per page (API caps at 50)."
  3. Added

TDQS

A3.6/5.0
Behavior3/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 safety is covered structurally. The description adds genuinely new context: reads survive a lapsed tracking plan, and apps-capable hosts render a browser while other clients get the same JSON. However, it says nothing about pagination, result volume, or what the host-rendered browser means for the agent's payload.

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

Conciseness4/5

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

Action routing is front-loaded in the first sentence, followed by prerequisites and caveats in descending order of importance. Each sentence carries information, though 'Resolve names before writes' is terse to the point of ambiguity in a read-only tool, and the host-rendering sentence is lower value than the rest.

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

Completeness4/5

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

For a 15-parameter, three-branch oneOf tool with no output schema, the description does the essential job: it distinguishes the three actions and their outputs at a conceptual level. Gaps remain around default page size, result shape, and how the oneOf constraint interacts with filter parameters, but nothing critical to calling it correctly is missing.

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

Parameters3/5

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

Schema coverage is 80%, so the structured fields already document the filters, sort direction, and date bounds; baseline 3 applies. The description adds one useful disambiguation, that contract lifecycle dates are distinct from signing deadlines, which explains the end_date_* filters. It adds nothing on search, status combinations, or the account_id/document_id split across the oneOf branches.

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 names a specific resource (contracts) and enumerates the three actions: list with filters, get for terms/amendment, and related for root plus amendments. An agent can map each action to a distinct read behavior without opening the schema. It stops short of naming sibling tools such as update_contract, so routing against alternatives is only partially supported.

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 clear context for each action (list/filters vs get vs related) and notes that reads keep working when the tracking plan lapses, which is useful selection context. It also warns to resolve names before writes, implying this is the lookup step ahead of a mutation. No explicit when-not-to-use or named alternative tool is provided.

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