DOCUMENT MCP TOOLS
Document MCP tools so your team (and agents) know what they do
Undocumented MCP servers slow onboarding and make risky calls more likely. Joyst lets you annotate and document MCP tools in your organisation’s private catalogue: living docs that people and agents share. It is not a public MCP directory. Everyone can see what each server does.
THE COST OF GUESSING
Document MCP tools and speed up onboarding
- Undocumented servers slow people down
New people and new agents cannot tell what a server offers, who owns it or whether it is approved. Guessing wastes time and adds risk.
- Notes next to the connection
When notes live beside the MCP server in the private catalogue, onboarding no longer depends on digging through old Slack threads.
- Clarity before wider use
Document MCP tools before more of the team uses them, so approval decisions rest on what each tool actually does.
ANNOTATE IN PLACE
Annotate tools in the catalogue
- Notes beside each tool
Add notes beside the tools your organisation connects. The explanation stays next to the connection rather than in a forgotten wiki page.
- Private to your organisation
Document the servers your team actually uses. Your notes are private to your organisation.
- Linked to approvals
Notes support approval decisions in the private MCP catalogue and under AI governance.
- One view for administrators
Administrators see connected servers, tools and notes in one place. Reviews are quicker, with fewer questions about what a tool does.
ONE SHARED RECORD
Living docs humans and agents share
- Notes stay with the server
Notes in the catalogue stay with the MCP server. When the connection changes, the description is still where people expect it.
- Same description for people and agents
Agents and people read the same description of what a tool is for, so everyone works from the same understanding.
- Feeds skills and agents
Approved, documented MCP servers are available to skills and agent packages, so setups stay consistent as tools improve.
- Not a public directory
Your notes live in your organisation’s private catalogue, not a public directory or marketplace.
RELATED
Keep exploring.
- Private vs public MCP registry
How a private approved list differs from a public marketplace.
Open - Skills registry
Manage, version and move skills across AI tools.
Open - Agents
Package skills, prompts, MCP servers and secrets into reusable setups.
Open - Secrets vault
Keys kept out of model context.
Open - AI governance
Permissions and an audit trail across the private catalogue.
Open - MCP security best practices
The risks worth knowing, and the controls that help.
Open
Document MCP tools FAQ
Add notes to servers and tools in your private catalogue, so descriptions live with the connection and people and agents share them.
No. The catalogue is private to your organisation.
Yes. Notes in the catalogue are written for both people and agents using approved tools.
Notes support approval decisions. You know what you are approving before it reaches wider use.
No. Joyst catalogues your skills, prompts, MCP servers, secrets and agents, and works alongside a developer portal.
Document your MCP tools in a private catalogue
Create an organisation account and bring skills, prompts, MCP servers, secrets and agents into one private catalogue.
- Private to your organisation
- Draft, then publish
- Limited open beta