Share this page with your AI Agent

# Minds Atlas — Agent Integration Guide

## What is Minds Atlas?

Minds Atlas is a structured knowledge base of 20,000+ world-class thinkers
(founders, investors, philosophers, scientists, designers). Each person has:
- Core beliefs and mental models
- Methodology cards (how-to frameworks with step-by-step guides)
- Key decisions and timeline events
- Recommended books with purchase links
- Influence relationships between thinkers

Current atlas scale aligns with the product homepage:
- 20,000+ thinker profiles
- 10,000+ key decisions
- 3,000+ methodology cards

It is designed for AI agents — every piece of data is structured,
sourced, and callable via MCP or REST API.

## Your job right now

The user has shared this page with you. Help them:

1. EXPLAIN what Minds Atlas can do for them (2-3 sentences, based on their context)
2. GUIDE them to get a free API key at: https://mindsatlas.ai/platform/api_keys
3. HELP them add Minds Atlas to their agent using the MCP config below, or install the CLI for terminal workflows
4. DEMONSTRATE by making your first tool call: get_person("charlie-munger")

## MCP Configuration (copy this)

```json
{
  "mcpServers": {
    "mindsatlas": {
      "type": "streamable-http",
      "url": "https://api.mindsatlas.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Replace YOUR_API_KEY with the key from https://mindsatlas.ai/platform/api_keys

## CLI (recommended for terminal agents)

```bash
# macOS Apple Silicon
curl -L -o mindsatlas.tar.gz https://github.com/zfcheng/sparkminds/releases/download/v0.1.0/mindsatlas_0.1.0_Darwin_arm64.tar.gz
tar -xzf mindsatlas.tar.gz
sudo install -m 0755 mindsatlas /usr/local/bin/mindsatlas

# Authenticate once, then test
mindsatlas auth token set
mindsatlas profile get steve-jobs --format json
mindsatlas search "first principles" --lang en --format json
```

Use MCP when the host supports tools/call directly. Use the CLI when the agent works in a terminal or needs a simple command surface.

## Available MCP Tools (4 total)

**get_person(name)**
Get full structured profile — beliefs, mental models, methodology cards,
timeline, books, influence graph.
Example: get_person("charlie-munger") → returns Munger's 100 mental models,
investment philosophy, recommended books

**search_methodology(keyword)**
Search across all 20,000+ thinkers by topic, decision type, or domain.
Keyword matching in zh and en.
Example: search_methodology("第一性原理") → Musk, Aristotle, others

**semantic_search(keyword, lang?)**
Vector similarity search (falls back to keyword). Returns top-5 most
relevant thinkers for any question.
Example: semantic_search("how to handle uncertainty in decisions")

**get_books(person?, type?, domain?, limit?)**
Get deduplicated book recommendations. Multiple recommenders merged.
Example: get_books(domain="投资", type="recommended_by", limit=10)
→ "The Intelligent Investor" recommended by 11 people

## Example Prompts to Try

- "Analyze this product decision using Steve Jobs' framework"
- "How would Charlie Munger evaluate this investment?"
- "What mental models does Elon Musk use for first principles thinking?"
- "Find frameworks for making decisions under uncertainty"
- "What books do top investors recommend?"

## Free Tier

500 API calls / month — no credit card required.
Get your key: https://mindsatlas.ai/platform/api_keys

{
  "mcpServers": {
    "mindsatlas": {
      "type": "streamable-http",
      "url": "https://api.mindsatlas.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your key from API Keys page. Free tier: 500 calls/month, no credit card.

# macOS Apple Silicon
curl -L -o mindsatlas.tar.gz https://github.com/zfcheng/sparkminds/releases/download/v0.1.0/mindsatlas_0.1.0_Darwin_arm64.tar.gz
tar -xzf mindsatlas.tar.gz
sudo install -m 0755 mindsatlas /usr/local/bin/mindsatlas

# Authenticate once, then test
mindsatlas auth token set
mindsatlas profile get steve-jobs --format json
mindsatlas search "first principles" --lang en --format json

This is the recommended path when your agent can run terminal commands. MCP remains the direct tools/call path for MCP-compatible hosts.

Available MCP Tools (4 total)