Integration

Corethesis

Name: Corethesis
Rating: 3.5 (1 reviews)
Author: SentientFlow-Solutions

By SentientFlow-Solutions 👁 49 views ▲ 0 votes

OpenClaw plugin: 16-tool bridge to the CoreThesis institutional-equity-research MCP server. Install via openclaw plugins install @sentientflowsolutions/openclaw-corethesis.

Homepage GitHub

Install

openclaw plugins install @sentientflowsolutions/openclaw-corethesis

Configuration Example

{
  "plugins": {
    "entries": {
      "corethesis": {
        "enabled": true,
        "config": {
          "mcp_url": "https://staging-corethesis-mcp.example.com/mcp",
          "enabled_tools": ["analyze_stock", "get_data"]
        }
      }
    }
  }
}

README

# @sentientflowsolutions/openclaw-corethesis

OpenClaw plugin that bridges the [CoreThesis](https://corethesis.io) institutional-equity-research MCP server into the agent loop. Adds **16 native tools** for stock analysis, news/press syntheses, watchlists, and natural-language Q&A — usable from any OpenClaw channel (WhatsApp, Slack, Discord, web, CLI, etc.).

## What you get

After installing and authenticating, the agent can answer prompts like:

- *"Analyze NVDA"* → full pre-computed synthesis with macro context, fundamentals, news, press
- *"How leveraged is Apple's balance sheet?"* → reasoning-first prose with the relevant value woven in
- *"Pull the data sheet for TSLA"* → ~389 raw metrics
- *"What news do we have on META in the last 7 days?"* → recent articles
- *"Summarize MSFT's recent press releases"* → identification + summarization
- *"What's the macro picture right now?"* → daily macro synthesis (FOMC, inflation, growth, breadth)
- Plus watchlist CRUD, history, search, and stable-citation re-fetch by id.

## Install

Requires Node 22+ and OpenClaw `>= 2026.1.0`.

```bash
openclaw plugins install @sentientflowsolutions/openclaw-corethesis
```

## Authenticate

1. Sign up at [corethesis.io](https://corethesis.io)
2. Mint a `ct_live_*` key from the `/keys` page
3. Add it to your OpenClaw env:

```bash
echo 'CORETHESIS_API_KEY=ct_live_…' >> ~/.openclaw/.env
```

## Enable

```bash
openclaw plugins enable corethesis
```

Then restart the gateway so it picks up the new plugin:

```bash
# If running as a daemon:
openclaw gateway restart

# If running interactively, Ctrl+C and re-run your gateway command.
```

That's it. Ask your OpenClaw agent anything from the [What you get](#what-you-get) list above.

## Verify it loaded

```bash
openclaw plugins list | grep -i corethesis
```

Should show `loaded` (not `disabled`). On the gateway's console you'll also see:

```
[corethesis-plugin] register() invoked — beginning plugin init
[corethesis-plugin] config ok — mcp=https://corethesis-mcp-server.sentientflowsolutions.com/mcp key=ct_live_…
[corethesis-plugin] registered 16 tools — first three: corethesis_analyze_stock, corethesis_get_news_synthesis, corethesis_get_press_releases_synthesis
```

## Tools registered

All 16 are namespaced under the `corethesis_` prefix to avoid collisions with core tools.

| Tool | What it does |
|---|---|
| `corethesis_analyze_stock` | Latest pre-computed synthesis for a covered ticker |
| `corethesis_get_data` | Natural-language Q&A on a ticker you've already analyzed |
| `corethesis_get_stock_data` | ~389 raw metrics (OHLCV, fundamentals, technicals, etc.) |
| `corethesis_get_news_synthesis` | AI-summarized news for a ticker |
| `corethesis_get_press_releases_synthesis` | AI-summarized press releases for a ticker |
| `corethesis_get_macro_synthesis` | Daily macro snapshot (FOMC, inflation, growth, breadth) |
| `corethesis_get_news_articles` | Raw news articles for a ticker |
| `corethesis_get_press_releases` | Raw press releases for a ticker |
| `corethesis_get_my_history` | Recent tool-call history |
| `corethesis_get_synthesis_by_id` | Re-fetch a prior synthesis (stable citations) |
| `corethesis_search_syntheses` | Search past syntheses by ticker / pipeline / date |
| `corethesis_list_watchlists` | List user's watchlists |
| `corethesis_create_watchlist` | Create a watchlist |
| `corethesis_update_watchlist` | Rename / replace tickers |
| `corethesis_delete_watchlist` | Delete a watchlist |
| `corethesis_get_documentation` | Self-onboarding reference |

## Configuration

Required env:

| Var | Notes |
|---|---|
| `CORETHESIS_API_KEY` | Your `ct_live_*` bearer token |

Optional env:

| Var | Default |
|---|---|
| `CORETHESIS_MCP_URL` | `https://corethesis-mcp-server.sentientflowsolutions.com/mcp` |

Optional plugin config in `~/.openclaw/openclaw.json`:

```json
{
  "plugins": {
    "entries": {
      "corethesis": {
        "enabled": true,
        "config": {
          "mcp_url": "https://staging-corethesis-mcp.example.com/mcp",
          "enabled_tools": ["analyze_stock", "get_data"]
        }
      }
    }
  }
}
```

`enabled_tools` is an explicit allowlist — if omitted, all 16 tools are exposed. Names are without the `corethesis_` prefix.

## Troubleshooting

**`disabled: CORETHESIS_API_KEY is not set`** — set the env var (see [Authenticate](#authenticate)) and restart the gateway.

**Plugin shows as `disabled` in `openclaw plugins list`** — run `openclaw plugins enable corethesis` then restart the gateway.

**Tools not appearing in chat** — check `openclaw plugins list` shows `loaded`. Look at gateway logs for `[corethesis-plugin] registered N tools`. If you see `disabled: …`, the API key isn't being read.

**`MCP HTTP 401 Unauthorized`** — your API key is invalid or revoked. Mint a new one at corethesis.io/keys.

## How it works

OpenClaw's plugin loader calls `register(api)` synchronously at gateway boot. The plugin registers all 16 tools immediately using a static catalog. Each tool's `execute()` is async and lazily opens a Streamable-HTTP MCP connection to `corethesis-mcp-server.sentientflowsolutions.com/mcp` on first use, authenticated with the `ct_live_*` bearer.

Source: [github.com/sentientflow-solutions/openclaw-corethesis](https://github.com/sentientflow-solutions/openclaw-corethesis)

## License

MIT — see [LICENSE](./LICENSE).

integration