StackResolve

Official15 tools

by autorevai · TypeScript

Find, compare, and audit software for AI agents. Scored registry of tools and MCP servers.

Model Context Protocol (MCP) Server: dev.stackresolve/stackresolve

The dev.stackresolve/stackresolve MCP server supports StackResolve, a scored registry for finding, comparing, and auditing software for AI agents. It operates via a TypeScript/Node SDK that is a thin, typed wrapper over the live StackResolve REST API, including workflows for software discovery and “AgentReady”/“CompanyData” calls.

🛠️ Key Features

Scored registry of tools and MCP servers
SDK wrapper over the live REST API
AgentReady software discovery and evaluation/selection
CompanyData structured company data calls for web research compression
MCP server registration for supported coding agents

🚀 Use Cases

Help AI agents discover and select compatible software
Evaluate software for agent readiness before installation
Convert web research into structured company data calls

⚡ Developer Benefits

Typed TypeScript/Node SDK
Thin wrapper around REST API (typed access)

⚠️ Limitations

Excerpt only references SDK-level MCP server registration for supported editors/agents (e.g., Claude Code, Cursor, Codex, Windsurf, VS Code); full MCP tool surface isn’t specified here.

Topics

agent-toolsai-agentsclaude-codecodexcursordeveloper-toolsllms-txtmcpmcp-server

Captured live from the server via tools/list.

resolve

Best tools for a natural-language task: resolves the task to the capabilities it needs, returns products that expose them ranked by fit and AgentReady score, each with a reason. Optional requirements (api/mcp/self_serve/openapi/cli) filter candidates. Set discover:true to search the web and audit new products into the registry when coverage is thin (slower, costs more).

Parameters7

task	string	required
api	boolean	optional
mcp	boolean	optional
self_serve	boolean	optional
openapi	boolean	optional
cli	boolean	optional
discover	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string"
    },
    "api": {
      "type": "boolean"
    },
    "mcp": {
      "type": "boolean"
    },
    "self_serve": {
      "type": "boolean"
    },
    "openapi": {
      "type": "boolean"
    },
    "cli": {
      "type": "boolean"
    },
    "discover": {
      "type": "boolean"
    }
  },
  "required": [
    "task"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

how_to

BEFORE building something, call this: returns the CURRENT (date-stamped), cited, tool-aware way to do a task, so you build from today's best practice instead of training-cutoff memory. Composes live web research + the tool resolver + one synthesis pass into { approach, recommendedTools, steps, gotchas, deprecated, sources, asOf }.

Parameters1

task

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string"
    }
  },
  "required": [
    "task"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_tools_for_task

Rank the software an agent should use for a task.

Parameters1

task

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string"
    }
  },
  "required": [
    "task"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_tools

Search the registry by query + requirements (api/mcp/self_serve/openapi/cli).

Parameters6

query	string	required
api	boolean	optional
mcp	boolean	optional
self_serve	boolean	optional
openapi	boolean	optional
cli	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "api": {
      "type": "boolean"
    },
    "mcp": {
      "type": "boolean"
    },
    "self_serve": {
      "type": "boolean"
    },
    "openapi": {
      "type": "boolean"
    },
    "cli": {
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_products

Compare products by slug.

Parameters1

slugs

array

required

Raw schema

{
  "type": "object",
  "properties": {
    "slugs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "slugs"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_profile

Full registry profile (AgentReady Score, capabilities, sources).

Parameters1

slug

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_registry

List the registry, highest AgentReady Score first.

Parameters3

category	string	optional
minScore	number	optional
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string"
    },
    "minScore": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

audit

Audit a product for agent-readiness.

Parameters1

domain

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

generate_agent_interfaces

Make a product agent-native: from its OpenAPI, generate an MCP server (one tool per operation), a CLI, an llms.txt, and Claude Code/Codex/Cursor install snippets.

Parameters2

domain	string	required
openapiUrl	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    },
    "openapiUrl": {
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_company

Structured company record.

Parameters1

domain

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_pricing

Normalized pricing.

Parameters1

domain

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

research_company

Grounded, cited answer about a company.

Parameters2

domain	string	required
question	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    },
    "question": {
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_competitors

Real competitors and alternatives for a company, extracted from live research and returned as structured rows.

Parameters2

domain	string	required
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_companies

Structured side-by-side of companies across fields (description, products, categories, funding, technology).

Parameters2

domains	array	required
fields	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "domains": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "domains"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_usage

Your usage this billing period (read-only).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md5 KBView on GitHub

stackresolve

Official TypeScript/Node SDK for the StackResolve API.

StackResolve helps agents discover, evaluate, select, install, and use software (AgentReady), and compresses web research into structured company data calls (CompanyData). This SDK is a thin, typed wrapper over the live REST API.

One line for your coding agent

bash

npx stackresolve@latest install

That mints an API key if you have none, registers the hosted MCP server for every coding agent on the machine (Claude Code, Cursor, Codex, Windsurf, VS Code), writes the StackResolve skill to ~/.claude/skills/stackresolve/SKILL.md, and verifies the key against the API. It is safe to re-run, and it backs up every file it changes.

bash

npx stackresolve@latest install --dry-run     # show what would change
npx stackresolve@latest install --cursor      # one agent only
npx stackresolve@latest install --project --rules   # also wire up the current repo

MCP server

The hosted server needs no install. The handshake and the registry reads (search_tools, get_profile, compare_products, list_registry) work without a key. Metered tools (resolve, how_to, audit, research_company, get_company, get_pricing) need a free key from https://stackresolve.dev/developers, sent as the x-api-key header.

Claude Code:

bash

claude mcp add --transport http stackresolve https://mcp.stackresolve.dev/mcp

Cursor (~/.cursor/mcp.json):

json

{
  "mcpServers": {
    "stackresolve": {
      "url": "https://mcp.stackresolve.dev/mcp",
      "headers": { "x-api-key": "ar_..." }
    }
  }
}

Codex (~/.codex/config.toml):

toml

[mcp_servers.stackresolve]
url = "https://mcp.stackresolve.dev/mcp"

[mcp_servers.stackresolve.headers]
x-api-key = "ar_..."

Tools: resolve, how_to, find_tools_for_task, search_tools, compare_products, get_profile, list_registry, audit, generate_agent_interfaces, get_company, get_pricing, research_company, find_competitors, compare_companies, get_usage.

CLI

bash

npm i -g stackresolve
stackresolve find "scrape javascript-heavy sites from claude code"
stackresolve audit stripe.com
stackresolve company vercel.com
stackresolve --help

Install

bash

npm install stackresolve      # SDK
npm i -g stackresolve         # CLI

Requires Node 18+ (uses the built-in global fetch). No runtime dependencies.

Quickstart

import { StackResolve } from 'stackresolve'

const sr = new StackResolve({ apiKey: process.env.STACKRESOLVE_API_KEY })

// 1. Audit a domain: AgentReady scores, facts, and issues.
const report = await sr.audit('stripe.com')
console.log(report.scores.agentready, report.issues)

// 2. Structured company data.
const company = await sr.getCompany('vercel.com')
console.log(company.name, company.description)

// 3. Task -> ranked, agent-ready tools.
const tools = await sr.findTools('send transactional email from a Node service')
console.log(tools.results)

// 4. Run an Agent Discovery check (needs an API key).
const discovery = await sr.runDiscovery('firecrawl')
console.log(discovery)

Authentication

Get an API key at stackresolve.dev. Pass it to the constructor, or set the STACKRESOLVE_API_KEY environment variable:

const sr = new StackResolve({ apiKey: 'ar_...' })
// or, reading STACKRESOLVE_API_KEY from the environment:
const sr2 = new StackResolve()

The key is sent as the x-api-key header on every request. Public endpoints (audit, search, profiles, company data, ...) work without a key, subject to an anonymous rate limit. Gated endpoints (monitors, usage, discovery runs) need one.

You can point the client at a different host with baseUrl or the STACKRESOLVE_BASE_URL environment variable:

const sr = new StackResolve({ apiKey, baseUrl: 'https://api.stackresolve.dev' })

Errors

Any non-2xx response throws a StackResolveError carrying the HTTP status and the parsed body:

import { StackResolve, StackResolveError } from 'stackresolve'

try {
  await sr.getUsage()
} catch (err) {
  if (err instanceof StackResolveError) {
    console.error(err.status, err.body)
  }
}

Methods

AgentReady: audit(domain), findTools(task), search(query, requirements?), compare(slugs), getProfile(slug), listRegistry(opts?), getCategories(), getCategory(slug), getDiscovery(slug), runDiscovery(slug), getScoreHistory(slug), generate(domain, openapiUrl?), deploy(domain, openapiUrl?).

CompanyData: getCompany(domain), getPricing(domain), getCompetitors(domain), research(domain, question?), compareCompanies(domains).

Monitors + account (API key required): listMonitors(), addMonitor(slug, opts?), runMonitorNow(slug), getUsage(), getMyProfile().

Other languages and frameworks

Python SDK:

bash

pip install stackresolve

LangChain tools, so an agent can pick software and research companies without a search-and-scrape loop:

bash

pip install langchain-stackresolve

python

from langchain_stackresolve import StackResolveToolkit
tools = StackResolveToolkit().get_tools()

REST directly: https://api.stackresolve.dev, OpenAPI at /openapi.json, llms.txt at /llms.txt.

License

MIT

Install

Tools (15)

resolvehow_tofind_tools_for_tasksearch_toolscompare_productsget_profilelist_registryaudit

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.stackresolve.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "stackresolve": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.stackresolve.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Model Context Protocol (MCP) Server: dev.stackresolve/stackresolve

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

resolve

how_to

find_tools_for_task

search_tools

compare_products

get_profile

list_registry

audit

generate_agent_interfaces

get_company

get_pricing

research_company

find_competitors

compare_companies

get_usage

stackresolve

One line for your coding agent

MCP server

CLI

Install

Quickstart

Authentication

Errors

Methods

Other languages and frameworks

License

Install

Remote endpoint

Related servers