Skip to content
Docs menu

Tool reference · Knowledge graph & temporal facts

analogize

Finds solutions, lessons and decisions from other projects that share words and features with the problem you describe.

local stdio server read-only

When to use

  • You are stuck and want to know whether a similar problem was solved in another project.
  • You are starting something new and want lessons learned elsewhere.
  • You want to exclude the current project so only outside experience shows up.

Parameters

NameTypeDefaultDescription
textrequired string — —
exclude_project string — —
only_types string[] ["solution","lesson","decision"] —
limit integer 10 —
min_score number 0.1 —

Example

Arguments

{
  "text": "Stripe webhook retries create duplicate orders",
  "exclude_project": "my-api",
  "limit": 3
}

Result shape

{
  "count": 1,
  "analogies": [
    {
      "id": 377,
      "type": "solution",
      "content": "Guard payment webhooks with an idempotency table keyed by event id.",
      "project": "shop-backend",
      "confidence": 0.9,
      "created_at": "2026-02-14T11:30:00Z",
      "analogy_score": 0.2143,
      "shared_features": [
        "duplicate",
        "stripe",
        "webhook"
      ]
    }
  ]
}

Scoring is Jaccard overlap of word features, so wording matters. Lower min_score to get more, looser matches.

Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.

Server description

The description the server sends to your agent in tools/list, captured from the v14.7.0 source:

Find past solutions/lessons from OTHER projects whose feature set overlaps with the given problem text (Jaccard similarity).

Found a mistake? Open an issue on GitHub.

Search