Skip to content

feat(claire): add 4 Claire MCP tools#15

Merged
paarths-collab merged 1 commit into
mainfrom
feat/claire-mcp-tools
Jun 17, 2026
Merged

feat(claire): add 4 Claire MCP tools#15
paarths-collab merged 1 commit into
mainfrom
feat/claire-mcp-tools

Conversation

@paarths-collab

Copy link
Copy Markdown
Contributor

Summary

  • Adds 4 Claire MCP tools to give Max's chat agent the same Claire access onboarding has
  • Thin proxy over the existing /api/v1/claire/* routes already on max-agent main — same service-secret + on-behalf-of pattern, no per-user Claire token needed
  • Pattern matches Apollo / Explorium (schema.ts, repository.ts, tools.ts), registered via registerClaireTools in mcp/register.ts

Tools added

Tool Purpose
claire_search Free-text research query (mode: lite/full)
claire_deep_research Multi-source background on a person or company
claire_market_watch Monitor a URL for market signals
claire_find_competitors Identify direct competitors of a company URL

All four are synchronous from the tool's POV — max-agent's shared runHubJob() handles Claire submit + poll internally and returns the final result.

How it flows

Max chat (Bearer JWT)
    → max-mcp-server (claire_*)
        → max-agent /api/v1/claire/* (authenticate, extract user.email)
            → claire-api with X-Service-Secret + X-On-Behalf-Of

Test plan

  • Deploy preview, point a Max chat session at it
  • In Max chat: "Research stripe.com and tell me what they do" → expect claire_deep_research call with entity_type: "company" returning result
  • In Max chat: "Find competitors of stripe.com" → expect claire_find_competitors returning a list
  • Verify no new env vars needed — DIGITALCREW_API_BASE_URL already covers it
  • Verify tsc --noEmit clean (verified locally)

🤖 Generated with Claude Code

…watch, find_competitors

Wires Max's chat agent into Claire via the existing /api/v1/claire/* proxy
in max-agent. Same service-secret + on-behalf-of pattern that onboarding
uses — no per-user Claire token needed; Max vouches for the user.

Tools:
- claire_search(query, mode?)
- claire_deep_research(name, entity_type, mode?)
- claire_market_watch(url, criteria?, mode?)
- claire_find_competitors(url)

All four are synchronous from the tool's POV: max-agent's shared
runHubJob() handles the Claire submit + poll internally and returns the
final result, so the MCP layer stays a thin proxy matching the Apollo /
Explorium pattern.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
max-mcp-server Ready Ready Preview, Comment Jun 17, 2026 2:31pm

Request Review

@paarths-collab paarths-collab merged commit 2d61c89 into main Jun 17, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant