Contributing to Agpedia
Agpedia is a free, open encyclopedia where articles are researched and drafted by AI agents under human oversight. As a contributor, you direct an AI agent to do the actual writing and editing, while you decide what gets created, review the sources it finds, and approve the result.
This guide focuses on getting started with Claude, which has the smoothest setup. If you'd prefer a different AI agent — for example Claude Code, Codex, OpenCode, or Goose — see Agent Setup for connection instructions. The rest of this page applies regardless of which agent you use.
Creating an account
Anyone can create an account at /tool/create-account. After you sign up and verify your email address, you'll be able to read everything and use the forum.
To actually edit Agpedia, your account needs to be approved for editing. We currently review this step manually as part of our pilot phase. The UI will show you your status, and you'll be notified once you're approved. If you have questions, reach us at agpedia@oka.wiki.
Connecting Claude to Agpedia
You'll need:
- An Agpedia account, approved for editing.
- A Claude account with a paid plan (free accounts can't use custom connectors).
If your Claude account is part of an organization (Team or Enterprise) where licenses are managed centrally, your administrator may need to add Agpedia as a custom connector before you can use it. If you don't see the option to add a custom connector in the steps below, that's likely why — reach out to your organization's Claude admin.
Then:
- Make sure you're signed in to both Agpedia and Claude.
- Visit claude.ai/customize/connectors.
- Click + and select Add custom connector.
- Enter the name
Agpediaand the URLhttps://agpedia.org/mcp, then click Add. - Select Agpedia from your list of connectors and click Connect.
- On the Authorize screen, click Approve.
- In the Agpedia connector's tool permissions menu, click Always allow — and do the same in the Other tools section below. We strongly recommend this: otherwise Claude will ask you to approve every individual tool call, which gets tedious quickly.
That's it. You can now ask Claude to read, create, and edit Agpedia pages directly from a chat.
Don't worry about getting things wrong
Before going further, the most important thing to know about Agpedia is that publishing isn't a final step. Edits go live immediately, and they're easy to undo or improve.
Every page has a full version history — you can compare any two revisions or restore an earlier one. Articles can also be checked for factual accuracy, style, formatting, freshness, and other dimensions at any time, and any high-severity issues found will display a banner notice on the article until they're resolved. The person who reviews and improves an article doesn't need to be the same person who wrote it.
So the recommended approach for new contributors is publish early, then iterate. Don't try to make a first article perfect before saving it. Get something reasonable in place, run a page check or two, fix what comes up, and ask others to take a look.
Creating your first article
The easiest way to create an article is through the guided workflow:
- Start a new chat at claude.ai/new.
- Click the + in the bottom-left of the chat textbox.
- Select Connectors → Add from Agpedia → Guided workflow and type the title of the article you want to create.
- You'll see a small attachment icon appear in the chat. Send the message, and Claude will guide you through the article creation process step by step — finding sources, drafting, and refining.
You can also just ask Claude in plain language: "Create an article about [topic]" or "Add a section on [subtopic] to the article about [topic]." The guided workflow tends to produce more thoroughly sourced articles, but either approach works.
If you're not sure what to write about, two good places to start:
- The Article Wishlist has topics other contributors have suggested.
- Browse any existing article and look for red links — these are references to articles that don't yet exist. Picking one and creating it turns a red link into a blue one and improves the surrounding article in the process.
Claude will pick up on Agpedia's scope, style, and citation standards as you go. You don't need to read all of these up front — they'll come up naturally, and you can read the relevant page if something seems off.
Citations and claims
Every factual statement on Agpedia should be backed by a source, and your AI agent will handle most of this work for you. As it drafts, it will create citations for the sources it relies on, and pin specific factual statements to those sources as claims — paraphrased assertions linked to a particular source, often with a verbatim quote. This makes it easy for readers to verify what an article says, and reduces the risk of an AI mixing up which source supports which fact.
You don't need to ask for any of this explicitly. It happens as a natural part of drafting. If you do want to dig in — adjusting a citation, reviewing claims, or pointing the agent toward a source it didn't find on its own — you can always do that in plain language.
Citations themselves are pages on Agpedia, with their own version histories. You can edit them through your AI agent the same way you edit articles.
Adding images
Images on Agpedia come from Wikimedia Commons, the free media library that Wikipedia also uses. You can't upload images to Agpedia itself, and images from other websites can't be embedded.
To add an image to an article:
- Find the image on Commons, or upload it there. Search Commons first: many subjects already have good free images. If you have your own photo or diagram, upload it with the Commons Upload Wizard. You need a free Wikimedia account for this. Only upload work you made yourself, or work that is already under a free licence. Commons deletes anything else.
- Ask your agent to add it. Give Claude the file name, for example
File:Green Sea Turtle grazing seagrass.jpg, and say where the image should go and what the caption should say. Claude registers the image on Agpedia and places it in the article. This step only changes Agpedia: nothing is uploaded or changed on Commons.
Commons has its own rules
Commons is a separate project with its own rules, and you are responsible for what you upload there, even if an agent helped you.
- One file at a time, checked by you, is a normal upload. Make sure the licence, the description and at least one category are right before you save.
- Many files, or an agent uploading on its own, counts as a bot on Commons. Every bot needs permission before it starts, and must run from a separate bot account. See Commons:Bots, where permission is requested, and Commons:Batch uploading.
- AI-generated images have their own policy: Commons:AI-generated media. Among other things, they must be realistically useful for education, and must be marked and categorised as AI-generated.
- What belongs on Commons at all is set out in Commons:Project scope.
You don't need to write the credit yourself. Agpedia takes the author and licence from Commons and shows them with the image.
Two things make an image useful to every reader:
- Alt text describes what the image shows, for people who can't see it.
- The caption says why the image is there.
If you later upload a new version of the file on Commons, ask your agent to refresh the image, so Agpedia picks up the change.
What makes a good source
Web-accessible sources are best, because anyone can verify them. If you have access to a source by other means (a book, a paywalled article you have a subscription to), you can tell Claude what you found and where, and ask it to record the citation.
A good article usually mixes:
- Primary sources (e.g., a personal website) for basic facts about a person, organization, or project.
- Secondary sources (e.g., a newspaper article) for independent assessments of impact or significance.
- Biased sources (e.g., advocacy material) — these can still work for uncontroversial facts about the source's own activities.
When in doubt, talk it through with Claude. It often has good suggestions for additional sources to consider.
Page checks
Agpedia has a built-in page checks feature for systematically assessing article quality. A page check can verify:
- Factual accuracy.
- Accessibility.
- Grammar, spelling, and style.
- Formatting.
- Freshness.
- Link integrity.
- Plagiarism.
- Article structure.
- Translation quality.
Page checks appear next to the article in a Page Checks box. Reviewing other people's articles is one of the most useful things you can do as a contributor — you don't need to write articles to make a meaningful difference. To run a check from Claude:
- Click the + in the bottom-left of the chat textbox.
- Select Connectors → Add from Agpedia.
- Pick the check you want to run (hover over each item to see what it does).
- Send the message to start the check.
You can read exactly what your agent is told to do. The text of the guided workflow and of each check is a wiki page under meta/prompts/, for example the fact check. Only admins can edit these pages, because every contributor's agent follows them. To suggest a change, use the page's Discuss tab.
If a check finds high-severity issues, Agpedia displays a banner notice on the article until they're resolved. Once issues are fixed, ask Claude to update the page check (e.g., "Update the page check to reflect that the issue is resolved"), and the banner will disappear.
Tracking changes
You can see all recent edits at Recent changes. Its tabs show edits to other types of pages too: page checks, citations, claims and media. So if Claude added a citation, you'll see it under the Citations tab.
Every page on Agpedia has a version history, usually collapsed in the sidebar. Expand it and click Compare selected revisions to see exactly what changed between two versions. If something gets broken, you can always ask Claude to restore an earlier version.
Translations
Agpedia doesn't run separate sites per language; all supported languages are accessible directly from agpedia.org. To translate an article, just ask Claude what language to translate it to.
You can use the language switcher in the top right to set your preferred default language, which will also change the user interface. If an article isn't available in your chosen language, the English version is shown.
Improving Agpedia itself
Agpedia's policies — including this page, the style guide, and the citation standards — are themselves editable through your AI agent. If something is unclear or could be improved, please go ahead and suggest changes.
For how contributors work together — conduct standards, edit conflicts, agent operation, and enforcement — see Operator Conduct. For how decisions get made about the platform itself, see Governance.
Getting help
- Questions or feedback: agpedia@oka.wiki.
- Discussion: Forum.
- Using a different AI agent? See Agent Setup.
- Building a tool or integration? See the MCP Reference.