AI knowledge base for OpenCode.
Add Perfect Wiki to OpenCode with a few lines of opencode.json. Whichever model you pair it with, your terminal agent can look up internal docs, cite the page it used, and keep that page accurate.
Connect OpenCode in two minutes.
Declare Perfect Wiki as a remote MCP server in opencode.json. The first time OpenCode connects, it notices the server needs sign-in and starts the OAuth flow for you.
- →Remote server entry — no local process to run
- →OAuth starts automatically on first connection
- →Global or per-project config, committed or not
Any model, your knowledge — always the current version.
Because the knowledge lives in Perfect Wiki rather than in a prompt file, every model you use in OpenCode sees the same up-to-date pages — and can edit them when you allow it.
- →Same knowledge base regardless of the model provider
- →No stale copies of docs pasted into AGENTS.md
- →Page edits only when the connection has write access
How to connect Perfect Wiki to OpenCode.
- 1Open
~/.config/opencode/opencode.json(oropencode.jsonin your project) and add theperfect-wikientry with"type": "remote"and the URLhttps://api.perfectwiki.xyz/mcp. Prefer a wizard? Runopencode mcp add. - 2Run
opencode mcp auth perfect-wiki— or just start OpenCode, which begins the OAuth flow when the server asks for authentication. - 3Sign in to Perfect Wiki in the browser, pick the knowledge base and click Allow access.
- 4Ask “What does our wiki say about feature flag cleanup?”
More details in the Perfect Wiki MCP server guide and OpenCode's MCP documentation.
Set "oauth": false so OpenCode doesn’t try to sign in, and export PERFECT_WIKI_TOKEN in your shell. The token is scoped to one knowledge base and has read & write access.
What your team does with Perfect Wiki in OpenCode.
Answers about “why”, not just “what”
The code shows what the system does; the wiki explains why. OpenCode can pull that context before touching sensitive areas.
Switch models, keep the context
Try a different provider for a task without re-explaining your conventions — the knowledge base comes along.
Fix the docs when you fix the bug
Found a troubleshooting page that’s wrong while debugging? Have OpenCode correct it on the spot.
Ask a natural-language question and get an AI answer with sources.
List every page in the connected knowledge base.
Read the full content of a specific page.
Create a new page — draft SOPs straight from chat.
Update an existing page, so SOPs never go stale.
Remove pages that are no longer needed.
Get info about the connected knowledge base.
Start from a ready-made SOP. Keep it alive here.
Download any of our 284 standard operating procedure templates in Word, PDF, Excel or CSV, no sign-up needed. Then put it in Perfect Wiki so your team can find it and ask about it.
Browse all 284 SOP templates →Frequently asked questions
Under the "mcp" key of ~/.config/opencode/opencode.json for every project, or opencode.json in a project root for that project only. Use "type": "remote" with the Perfect Wiki URL.
OpenCode starts OAuth automatically when the server responds that authentication is required. You can also run opencode mcp auth perfect-wiki to sign in explicitly.
Yes. Add "oauth": false and a headers object with "Authorization": "Bearer {env:PERFECT_WIKI_TOKEN}", then export the token as an environment variable so it stays out of the config file.
Only if you allow it. When you connect with OAuth you choose read-only (wiki:read) or read & write (wiki:write) on the consent screen. Legacy API tokens always have full access to their knowledge base. Most MCP clients also ask for your confirmation before running a tool that writes.
Yes. Each connection is scoped to one knowledge base, so add the server once per knowledge base and give each a unique name — for example perfect-wiki-hr and perfect-wiki-engineering. The assistant can then search or update a specific knowledge base by name.
The Perfect Wiki MCP server only forwards the requests OpenCode makes. Tool results — the pages and answers it fetches — are passed to the model as part of the conversation and handled under your AI provider's data policy.
The MCP server is included in every Perfect Wiki plan, and the same API rate limits apply. You can try it with the 14-day free trial — no credit card required.
Didn't find what you're looking for? Contact our support →
Put your SOPs to work in OpenCode.
Keep your SOPs, manuals and FAQs in Perfect Wiki — and give your whole team answers right where they work.