Connect with OpenCode

Requirements

• OpenCode installed
• A Knowatoa account

Setup

1. Add Knowatoa to your opencode.json (project root or ~/.config/opencode/opencode.json):

{ "$schema": "https://opencode.ai/config.json", "mcp": { "knowatoa": { "type": "remote", "url": "https://knowatoa.com/mcp" } } }

1. Authenticate:

opencode mcp auth knowatoa

OpenCode opens your browser so you can sign in to Knowatoa. After signing in, you’re connected.

Usage

Once connected, ask OpenCode about your AI search data:

• “How visible is my brand in AI search?”
• “Show me my competitor comparison”
• “List my tracked questions”
• “Add a new question to track”

Removing the connection

Set "enabled": false on the entry to temporarily disable, or delete the knowatoa block from opencode.json to remove it.

Troubleshooting

Browser login doesn’t complete Check that you’re signing in with the same email address associated with your Knowatoa account.

Authentication error Tokens refresh automatically in the background. If you ever do get an auth error, sign in again — that usually means the refresh token was revoked or your client cleared it.