Skip to main content
Glama

Crypto & Macro Market Data (Tanod)

sec_company_lookup

Read-onlyIdempotent

utilpeek: Look up a company in SEC EDGAR by ticker or CIK. For financials per year or quarter use sec_financials. Returns a US SEC registrant by ticker or CIK from SEC EDGAR: name, CIK, tickers, exchanges, SIC industry, state, fiscal year end and the latest 10 filings with links; with include_facts, the latest annual revenue, net income, total assets (USD) and shares outstanding. Informational only, not investment advice. Data: SEC EDGAR (public domain), cached up to 1 hour; no SEC endorsement implied. Send exactly one of ticker or cik; bad input is a 422 and an unknown company a 404 company_not_found (neither charged); an upstream outage is a 503 (not charged). Typically 1-3 s (cached under 0.1 s). Price: USD 0.003. Free: 10 utilpeek calls per IP per UTC day. Docs: https://tanod.dev/learn/sec-edgar-company-filings-api.html

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": "sec_company_lookup"
  }
}

Input Schema

NameRequiredDescriptionDefault
cikNoSEC Central Index Key, 1-10 digits, as a number or a string (leading zeros and a CIK prefix allowed, such as 320193 or 0000320193). Send ticker or cik.
tickerNoExchange ticker such as AAPL (class shares as BRK-B, BRK.B or BRK/B). Send ticker or cik.
include_factsNoAlso return headline XBRL facts: latest annual revenue, net income and total assets (USD) and shares outstanding.

Output Schema

NameRequiredDescriptionDefault
cikNo
sicNo
nameNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
factsNo
staleNo
cachedNo
sourceNo
filingsNo
tickersNo
exchangesNo
disclaimerNo
facts_noteNo
cache_secondsNo
fiscalYearEndNo
sicDescriptionNo
stateOfIncorporationNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed11 schema fields changed
    • removedInput schema / properties / cik / default
      Removed value: -null
    • removedInput schema / properties / cik / title
      Removed value: -"Cik"
    • removedInput schema / properties / include_facts / title
      Removed value: -"Include Facts"
    • removedInput schema / properties / ticker / default
      Removed value: -null
    • removedInput schema / properties / ticker / title
      Removed value: -"Ticker"
    • removedInput schema / title
      Removed value: -"sec_company_lookupArguments"
    • removedOutput schema / properties / exchanges / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / facts / properties
      Removed value: -{
      -  "assets": {
      -    "properties": {
      -      "concept": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "filed": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "fiscalYear": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "form": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "periodEnd": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "periodStart": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "unit": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "value": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "netIncome": {
      -    "properties": {
      -      "concept": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "filed": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "fiscalYear": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "form": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "periodEnd": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "periodStart": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "unit": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "value": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "revenue": {
      -    "properties": {
      -      "concept": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "filed": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "fiscalYear": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "form": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "periodEnd": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "periodStart": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "unit": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "value": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "sharesOutstanding": {
      -    "properties": {
      -      "concept": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "filed": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "fiscalYear": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "form": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "periodEnd": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "periodStart": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "unit": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "value": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / filings / items
      Removed value: -{
      -  "properties": {
      -    "accessionNumber": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "filingDate": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "form": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "primaryDocument": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "primaryDocumentUrl": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / source / properties
      Removed value: -{
      -  "license": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "name": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "notice": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "terms": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "url": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / tickers / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "cache_seconds": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "cached": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "cik": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "disclaimer": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "error": {
      +      "description": "Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object."
      +    },
      +    "exchanges": {
      +      "items": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "facts": {
      +      "properties": {
      +        "assets": {
      +          "properties": {
      +            "concept": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "filed": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "fiscalYear": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "form": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "periodEnd": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "periodStart": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "unit": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "value": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          },
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "netIncome": {
      +          "properties": {
      +            "concept": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "filed": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "fiscalYear": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "form": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "periodEnd": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "periodStart": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "unit": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "value": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          },
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "revenue": {
      +          "properties": {
      +            "concept": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "filed": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "fiscalYear": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "form": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "periodEnd": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "periodStart": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "unit": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "value": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          },
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "sharesOutstanding": {
      +          "properties": {
      +            "concept": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "filed": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "fiscalYear": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "form": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "periodEnd": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "periodStart": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "unit": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "value": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          },
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "facts_note": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "filings": {
      +      "items": {
      +        "properties": {
      +          "accessionNumber": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "filingDate": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "form": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "primaryDocument": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "primaryDocumentUrl": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "maxItems": 10,
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "fiscalYearEnd": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "name": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "sic": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "sicDescription": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "source": {
      +      "properties": {
      +        "license": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "notice": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "terms": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "stale": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "stateOfIncorporation": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "tickers": {
      +      "items": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  3. First observed

TDQS

A4.8/5.0
Behavior5/5

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

Annotations already declare read-only, idempotent, open-world and non-destructive, and the description adds substantial context beyond them: cache TTL up to 1 hour, typical 1-3 s vs sub-0.1 s cached latency, which error codes are not charged, price per call, and the free-tier quota. These are exactly the operational facts an agent needs to decide whether to call it.

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?

Purpose and sibling routing are front-loaded in the first two sentences, with operational details following. A few sentences are boilerplate (data attribution, non-endorsement, not-investment-advice, docs URL) that dilute a very dense block, though most of it is justified for a metered paid API.

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?

Despite only three optional parameters, the tool carries pricing, caching, latency, error semantics and quotas, all of which are disclosed. Return values are described and an output schema exists, so nothing material for correct invocation is missing.

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 the baseline is 3, but the description adds a real constraint the schema does not state: exactly one of ticker or cik must be sent. It also clarifies the value of include_facts ('latest annual revenue, net income, total assets (USD) and shares outstanding'), matching the schema without adding much beyond it.

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 ('Look up a company in SEC EDGAR by ticker or CIK') and immediately names the sibling it is not ('For financials per year or quarter use sec_financials'). The returned fields are enumerated, so an agent knows exactly what this tool produces versus sec_financials.

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

Usage Guidelines5/5

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

Explicit routing guidance is given ('For financials per year or quarter use sec_financials'), plus an input-exclusivity rule ('Send exactly one of ticker or cik') and the failure modes that select behaviour (422, 404, 503). The agent knows both when to pick this tool and what to expect when input is wrong.

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.