Skip to main content
Glama

Search trademarks

firmafakta_trademarks
Read-only

Search Swedish trademarks (PRV) by text in the mark, by a picture of it (image), or by the marks' facts in the segment language's trademark words (as inside varumärke(…); see describe's mark_fields), or both; ended marks only with include_ended. Each result gives the mark and its owners: a company with its org number, which firmafakta_lookup opens, a person only as a private person. Costs credits per search, not per page; continue with next. See describe.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "firmafakta_trademarks"
  }
}

Input Schema

NameRequiredDescriptionDefault
nextNothe next value of the previous page, alone, to continue the same search without a new charge
textNowords in the mark, at least 3 characters; closest matches first
imageNoa picture of a mark, base64 (PNG, JPEG, GIF or WebP, at most 5 MB): the 50 marks that look most like it, one page
limitNomarks per page, 1 to 50, default 20
segmentNoconditions on the mark in the segment language's trademark words, as inside varumärke(…), e.g. klass = 25 & ägare = företag
include_endedNoalso marks that have ended (by status or a passed expiry date)

Output Schema

NameRequiredDescriptionDefault
nextNo
marksNo
totalNothe marks found, counted up to 1000
usageNo
total_at_leastNotrue when total is the count's cap: at least that many marks match; narrow the search to count them

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / total_at_least
      Added value: +{
      +  "description": "true when total is the count's cap: at least that many marks match; narrow the search to count them"
      +}
  2. Changed59 schema fields changed
    • addedOutput schema / properties / marks / items / properties / classes / items / title
      Added value: +"classes"
    • removedOutput schema / properties / marks / items / properties / classes / items / type
      Removed value: -"integer"
    • addedOutput schema / properties / marks / items / properties / classes / title
      Added value: +"classes"
    • removedOutput schema / properties / marks / items / properties / classes / type
      Removed value: -[
      -  "null",
      -  "array"
      -]
    • removedOutput schema / properties / marks / items / properties / image_url / type
      Removed value: -"string"
    • addedOutput schema / properties / marks / items / properties / kind / title
      Added value: +"kind"
    • removedOutput schema / properties / marks / items / properties / kind / type
      Removed value: -"string"
    • addedOutput schema / properties / marks / items / properties / number / title
      Added value: +"number"
    • removedOutput schema / properties / marks / items / properties / number / type
      Removed value: -"string"
    • addedOutput schema / properties / marks / items / properties / office / title
      Added value: +"office"
    • removedOutput schema / properties / marks / items / properties / office / type
      Removed value: -"string"
    • addedOutput schema / properties / marks / items / properties / owners / items / properties / country / title
      Added value: +"country"
    • removedOutput schema / properties / marks / items / properties / owners / items / properties / country / type
      Removed value: -"string"
    • removedOutput schema / properties / marks / items / properties / owners / items / properties / kind / type
      Removed value: -"string"
    • addedOutput schema / properties / marks / items / properties / owners / items / properties / name / title
      Added value: +"name"
    • removedOutput schema / properties / marks / items / properties / owners / items / properties / name / type
      Removed value: -"string"
    • removedOutput schema / properties / marks / items / properties / owners / items / properties / org_number / type
      Removed value: -"string"
    • removedOutput schema / properties / marks / items / properties / owners / items / required
      Removed value: -[
      -  "kind"
      -]
    • addedOutput schema / properties / marks / items / properties / owners / items / title
      Added value: +"owners"
    • removedOutput schema / properties / marks / items / properties / owners / items / type
      Removed value: -"object"
    • addedOutput schema / properties / marks / items / properties / owners / title
      Added value: +"owners"
    • removedOutput schema / properties / marks / items / properties / owners / type
      Removed value: -[
      -  "null",
      -  "array"
      -]
    • removedOutput schema / properties / marks / items / properties / similarity / type
      Removed value: -"integer"
    • addedOutput schema / properties / marks / items / properties / status / title
      Added value: +"status"
    • removedOutput schema / properties / marks / items / properties / status / type
      Removed value: -"string"
    • addedOutput schema / properties / marks / items / properties / words / title
      Added value: +"words"
    • removedOutput schema / properties / marks / items / properties / words / type
      Removed value: -"string"
    • removedOutput schema / properties / marks / items / required
      Removed value: -[
      -  "office",
      -  "number",
      -  "words",
      -  "status",
      -  "kind",
      -  "classes",
      -  "owners"
      -]
    • addedOutput schema / properties / marks / items / title
      Added value: +"marks"
    • removedOutput schema / properties / marks / items / type
      Removed value: -"object"
    • addedOutput schema / properties / marks / title
      Added value: +"marks"
    • removedOutput schema / properties / marks / type
      Removed value: -[
      -  "null",
      -  "array"
      -]
    • addedOutput schema / properties / next / title
      Added value: +"next"
    • removedOutput schema / properties / next / type
      Removed value: -"string"
    • removedOutput schema / properties / total / type
      Removed value: -"integer"
    • removedOutput schema / properties / usage / properties / credits_charged / maximum
      Removed value: -2147483647
    • removedOutput schema / properties / usage / properties / credits_charged / minimum
      Removed value: --2147483648
    • addedOutput schema / properties / usage / properties / credits_charged / title
      Added value: +"credits_charged"
    • removedOutput schema / properties / usage / properties / credits_charged / type
      Removed value: -"integer"
    • removedOutput schema / properties / usage / properties / credits_left / maximum
      Removed value: -2147483647
    • removedOutput schema / properties / usage / properties / credits_left / minimum
      Removed value: --2147483648
    • addedOutput schema / properties / usage / properties / credits_left / title
      Added value: +"credits_left"
    • removedOutput schema / properties / usage / properties / credits_left / type
      Removed value: -[
      -  "null",
      -  "integer"
      -]
    • removedOutput schema / properties / usage / properties / offer
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / usage / properties / plan / title
      Added value: +"plan"
    • removedOutput schema / properties / usage / properties / plan / type
      Removed value: -"string"
    • addedOutput schema / properties / usage / properties / refills_on / title
      Added value: +"refills_on"
    • removedOutput schema / properties / usage / properties / refills_on / type
      Removed value: -"string"
    • addedOutput schema / properties / usage / properties / throttled / properties / plan / title
      Added value: +"plan"
    • removedOutput schema / properties / usage / properties / throttled / properties / plan / type
      Removed value: -"string"
    • addedOutput schema / properties / usage / properties / throttled / properties / waited_ms / title
      Added value: +"waited_ms"
    • removedOutput schema / properties / usage / properties / throttled / properties / waited_ms / type
      Removed value: -"integer"
    • removedOutput schema / properties / usage / properties / throttled / required
      Removed value: -[
      -  "waited_ms",
      -  "plan"
      -]
    • addedOutput schema / properties / usage / properties / throttled / title
      Added value: +"throttled"
    • removedOutput schema / properties / usage / properties / throttled / type
      Removed value: -[
      -  "null",
      -  "object"
      -]
    • removedOutput schema / properties / usage / required
      Removed value: -[
      -  "plan",
      -  "credits_charged"
      -]
    • addedOutput schema / properties / usage / title
      Added value: +"usage"
    • removedOutput schema / properties / usage / type
      Removed value: -"object"
    • removedOutput schema / required
      Removed value: -[
      -  "total",
      -  "marks",
      -  "usage"
      -]
  3. Changed2 schema fields changed
    • changedOutput schema / properties / marks / items / properties / owners / items / properties / org_number / description
      Previous value: -"a company's org number"New value: +"a company's org number, which firmafakta_lookup opens; none for a private person"
    • removedOutput schema / properties / marks / items / properties / owners / items / properties / ref
      Removed value: -{
      -  "description": "a company's ref for firmafakta_lookup",
      -  "type": "string"
      -}
  4. Added

TDQS

A4.5/5.0
Behavior5/5

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

Goes well beyond the readOnly/non-destructive annotations by disclosing the credit model (charged per search, not per page), that continuing with `next` incurs no new charge, the image-mode result cap of 50, and the exact result shape (mark plus owners, companies with an openable org number, persons only as private persons). This is the kind of cost and result semantics an agent needs before spending credits.

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?

Front-loads the search modalities before secondary details, and every sentence carries information (modes, result shape, cost, continuation). It is dense and semicolon-heavy, and the pointer "see describe" appears twice with slightly different targets, which mildly hurts scannability.

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?

An output schema exists, yet the description still usefully summarizes result content, and it covers cost, pagination, and filtering behavior for a 6-parameter tool with optional inputs. The only soft spot is the vague "See describe" closing pointer, which does not say what else an agent should verify there.

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?

Schema coverage is 100%, so baseline is 3; the description earns an extra point by explaining what `segment` means (trademark words as inside varumärke(…)) and cross-referencing describe's mark_fields, and by clarifying that `next` continues the same search without new cost. Remaining parameters (limit, image, include_ended) merely restate the schema.

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

Purpose5/5

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

States a specific verb and resource ("Search Swedish trademarks (PRV)") and enumerates the three distinct search modes: text in the mark, image of the mark, and segment-language trademark conditions. An agent can distinguish this from firmafakta_company or firmafakta_lookup purely from the description.

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?

Gives clear per-mode guidance (text, image, segment) and routes the agent to firmafakta_lookup to open a returned company via its org number, plus include_ended for ended marks. It does not state when to prefer a sibling such as firmafakta_count for totals or when a trademark search is the wrong tool, so no explicit exclusions.

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.