Connect vibecheck to your AI agent

Vibecheck lets an AI agent, with your consent, send one first-person statement to SomaCheck for you to test with a phone gesture. The agent receives an Aligned or Unaligned signal with confidence and can use it as context. The result reflects model-interpreted inner conflict relative to the statement. It does not establish the cause, meaning, or right response. You remain the authority.

Before you connect

Install the SomaCheck public beta from TestFlight at https://testflight.apple.com/join/C4mAH3zz. The current public beta is SomaCheck 1.0 (39).
Open SomaCheck once and complete its in-app setup.
For a local client, open Settings > Agent > Connect your agent and keep the one-time command on screen.

Claude Code

Run the one-time link command shown in SomaCheck. If you are running it from a local agent session instead of Terminal, name Claude explicitly:

npx -y @somacheck/vibecheck@0.6.6 link <CODE> --client claude

The command stores the private link credential on your computer, registers the pinned MCP command, and installs the user-scoped continuation plugin. Restart Claude Code, then ask: Give me a SomaCheck vibecheck based on what you know about me.

Codex

Run the one-time link command shown in SomaCheck. If you are running it from a local agent session instead of Terminal, name Codex explicitly:

npx -y @somacheck/vibecheck@0.6.6 link <CODE> --client codex

Restart Codex after setup, then ask: Give me a SomaCheck vibecheck based on what you know about me.

Claude.ai

Claude.ai uses the hosted MCP. It does not run the npm package on your computer.

Open Customize > Connectors at https://claude.ai/customize/connectors.
Select +, then Add custom connector.
Enter https://mcp.somacheck.com/functions/v1/mcp and select Add.
Complete OAuth and enable the connector in a conversation.
Ask for a SomaCheck vibecheck and complete it on your phone.

On Team and Enterprise plans, an Owner must add the connector in organization settings before members can connect it.

Hosted or local

Path	Best for	Credential
Local npm	Claude Code and Codex	Stored on your computer in a private config file
Hosted MCP	Claude.ai	Managed through OAuth and your Claude account

Both paths expose the same six tools. Claude Code can continue the same open session when a delayed result arrives. Other MCP clients may require one explicit result check after the bounded wait.

The six tools

get_vibecheck_context: Reads recent completed gesture signals for this exact agent link.
get_vibecheck_status: Checks the reflection feed and how many distinct statements it needs.
share_somacheck_context: Shares bounded observations that you explicitly allow, never a raw conversation.
post_vibecheck_statement: Adds one to three statements to the reflection feed without blocking.
get_vibecheck_result: Reads the status or exact result for one request handle.
request_vibecheck: Sends one consented statement to the phone and waits briefly for its exact result.

What crosses the connection

The statement you or your agent chose for this vibecheck.
The consent basis for the request.
The Aligned or Unaligned signal, confidence, and request status.
Only bounded observations you explicitly allow an agent to share.

What never crosses

Raw accelerometer or gyroscope motion data.
Your conversation history.
Photos, health records, credentials, or secret values.
A reading about anyone except the person using SomaCheck.

Revoke access

In SomaCheck, open Settings > Agent, select the connection, and revoke it. For Claude.ai, you can also remove the custom connector under Customize > Connectors. Revoking one connection does not revoke another independently linked client.

Troubleshooting

The client was configured, but setup says this computer is not linked

Client registration and phone linking are separate. Open SomaCheck at Settings > Agent > Connect your agent and run the one-time command shown there.

The client does not show vibecheck after setup

Restart the client. For local setup, run the matching repair command and then the connection check:

npx -y @somacheck/vibecheck@0.6.6 setup claude
npx -y @somacheck/vibecheck@0.6.6 setup codex
npx -y @somacheck/vibecheck@0.6.6 doctor

Claude.ai does not offer Add custom connector

Check the plan and organization role. Individual Pro and Max users can add a custom connector. Team and Enterprise members need an Owner to add it first.

No result arrived before the tool call ended

The request can remain pending after the bounded wait. Ask the agent to check that exact request once. Do not create a replacement unless you intend to send another phone notification.

Wellness boundary

SomaCheck is a general wellness tool. It is not a medical device and does not diagnose or treat any condition. A vibecheck is a signal that may be worth noticing. It does not replace care from a qualified professional or decide what you should do.