getPlatformInfo
About 1lev1- Read-only
Get general information about the 1lev1 platform, its goals, and features.
Inputs
No inputs.
The agent you already work with can run your partnerships without opening a browser.
The command opens 1lev1 in your browser, you approve the connection, and the key is written into every agent you have installed — together with the skill.
npx 1lev1-mcp Restart your agent afterwards so it picks up the new configuration.
The Claude app, claude.ai and Claude Code in the browser connect through a connector: you paste one address, approve it in the browser, and that is it. No key to copy, no config file to edit.
Server endpoint
https://api.1lev1.com/api/mcp The connection mints an ordinary API key on your account. It shows up on the API keys page and is revoked from there, exactly like a key created from the terminal.
If you work in Claude Code you can install the skill from the marketplace, then connect your account with the command above.
/plugin marketplace add Avi-ADAM/1lev1-agent /plugin install 1lev1@1lev1 The plugin brings the knowledge; the connect command brings the access. You need both.
1lev1 runs on consent, so the agent never performs an act that touches another person. Instead it prepares the form and sends you to approve it on the site.
MCP is an open protocol that lets an AI agent connect to outside services. The 1lev1 MCP server gives your agent access to your missions, timers and partnerships — and only yours. The skill installed alongside it teaches the agent how the platform works: what a rikma is, why logged hours are ownership, and what it must never do on somebody else's behalf.
The command detects what you actually have installed and writes only to that: Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Roo Code, Continue, Antigravity and VS Code. It leaves alone any config file it cannot parse, and backs up every file before changing it.
The server speaks standard MCP, so it is not Claude-only. What works today:
[mcp_servers.lev1]
url = "https://api.1lev1.com/api/mcp"
bearer_token_env_var = "LEV1_API_KEY" The consumer Gemini app still does not let you add an MCP server yourself — connections there open only through partnerships with Google.
If your agent is not on the list you can add the server by hand. Get the key from the command above.
Server endpoint
https://api.1lev1.com/api/mcp {
"mcpServers": {
"1lev1-mcp": {
"type": "http",
"url": "https://api.1lev1.com/api/mcp",
"headers": { "Authorization": "Bearer 1lev1_..." }
}
}
} To disconnect completely, this command removes the server and the skill from every agent.
npx 1lev1-mcp remove That command only cleans up your local configs — the key itself stays valid. To invalidate it, run the connect command again and approve: it replaces the previous key.
For AI assistants
Every tool the connector gives a signed-in account, read from the server itself - so this list is always the one your assistant gets. Tool descriptions are what the assistant reads, so they stay in English.
How the connector handles your information
Answer before anyone signs in. prepareSignup saves a signup draft for someone with no account yet - their name, email and what they came for - that binds nobody until they sign it themselves, and expires after 14 days. Every other tool asks the person to sign in first.
getPlatformInfoGet general information about the 1lev1 platform, its goals, and features.
No inputs.
Reads only. Returns what you could see on the site yourself.
findUserProjectsToolFind the projects (rikmot) the current user belongs to, newest first, with their creation time. Use this when the user mentions a project by name, wants to navigate to one, or just created one. Results are paginated: when hasMore is true, call again with offset=nextOffset.
userId string optionalquery string optionallimit integer optionaloffset integer optionalgetProjectDetailsToolGet the facts about one rikma (project): name, public description, values, links (website, GitHub, Drive, social), members, roles, open missions, missions in progress (and who holds them), open and in-progress resources, and products. Call this before planning or writing anything in a rikma - it is cheap and returns facts, unlike scanProjectDirectionsTool. For a rikma the user is not a member of, only the public face is returned (isMember:false).
projectId string requiredlistProjectResourcesToolList what a rikma already has and needs: its links (live website, repo, Drive, social), resources in progress (equipment, money, services someone provides) and open resources it is looking for, plus its products. Use it to check whether a rikma already has a website/repo before suggesting one. Members only.
projectId string requiredgetProjectStatsToolGet the pulse of one rikma as numbers: members, open missions, missions in progress, open resources, open decisions (votes), active timers, missions finished and hours logged in the last N days, and when anything last happened. Use it to judge whether a rikma is active before planning. Members only; no per-member financial data.
projectId string requireddays integer optionalgetProjectMembersToolList the people (members) and roles (tafkidim) of a project. Use this to resolve a task assignee - a person or a role - to its ID before calling createTaskTool. For a task with no specific person, pick the roles that fit it here and pass their IDs as tafkidims.
projectId string requiredquery string optionalgetMemberMissionsToolList a project member's in-progress missions. A task is linked to a mission-in-progress the assignee performs, so call this after choosing the assignee (a person) to pick the missionId to pass to createTaskTool. If no mission in progress covers the work, it is not a task: prepare a mission with prepareMissionTool instead.
projectId string requireduserId string requiredgetMissionDetailsToolGet detailed information about a specific mission including tasks, timeline, and current status
missionId string requiredlistUserMissionsToolList user missions with various filtering options
filter "all" | "active" | "completed" | "startable" | "stoppable" | "overdue" optionalprojectId string optionalprojectName string optionalmissionName string optionallimit number optionalfindMissionToolFind a specific mission for the user by its name.
missionName string requiredgetActiveTimersToolGet all currently active timers for the user
includeDetails boolean optionalgetMissionStatsToolGet statistics about user missions including counts by status, time spent, etc.
projectId string optionalsearchCatalogToolSearch what the platform already offers publicly: products for sale, open missions (work looking for someone) and open resources (equipment, money, services a rikma needs). Use it before opening a new wish or mission - somebody may already do this. Public data only.
query string requiredkinds "products" | "missions" | "resources"[] optionallimit integer optionalsearchContentToolSearch inside the rikmas the caller belongs to: rikma names and descriptions, open missions, missions in progress, acts, open and in-progress resources, and products. Use it to find something when the rikma is not known - "where was that task about the logo". For public listings of other rikmas use searchCatalogTool instead.
query string requiredlimit integer optionallistMyWishesToolList the caller's own wishes (concierge requests): status, coverage, and how many missions and resources each one still needs. Use it to answer "what did I ask for" and to pick the wish a follow-up is about.
No inputs.
getWishDetailsToolGet one wish (concierge request): what it needs broken into missions and resources, its coverage, and the proposals on it. Full detail for the wish owner and for anyone who proposed on it; others see only the public card of an open wish. Accepting or declining a proposal is never done here - open the returned URL and let the person decide.
wishId string requiredlistMyWishOffersToolThe supplier side of the concierge: every proposal the caller is the proposer of - what someone asked them to provide and what they offered, with its status. Use it to answer "who wants something from me". Responding to one happens on its page, not here.
No inputs.
getMyUpdatesToolWhat waits for the user and what is new for them - across their rikmas, their wishes (concierge) and their deals. Use it for "what's new today", "what is waiting for me", "what do I need to answer", "what is happening in rikma X". Returns `waiting`: each item is ONE ready sentence in the user's language, with its figures, where it is, its deadline (when `silenceApproves` is true, no answer by the deadline approves it automatically - always say so), and a `link` where the user answers it. Relay the sentences, most urgent first; do not reword figures. Also returns `work` (their missions, missions about to go dormant, open/overdue tasks), `whatsNew` (counts of new missions/resources/products/sales in their rikmas since yesterday) and `suggestions` (open matches for them). `unavailable` names parts that could not be read - say they could not be checked rather than calling them empty. Read-only: approving, countering or discussing happens on the site, by the user.
projectId string optionalrikma string optionallang "he" | "en" | "ar" | "ru" | "es" optionallimit integer optionallistMyConversationsToolList the conversations (forums) the caller takes part in - one per mission, act, decision, profit split or wish proposal they are involved in, newest first, with the last message. Use it to find the forumId of the thread a request is about.
projectId string optionallimit integer optionalreadConversationToolRead one conversation (forum) the caller takes part in: its messages, newest last, with who wrote each. Use it before answering in a thread, so the reply fits what was already said.
forumId string requiredlimit integer optionalgetSitePagesToolGet a structured list of available pages on the 1lev1.com site, useful for navigation.
No inputs.
listRikmaProcessesToolList a rikma's processes: the open-ended threads it is running - an approach to a partner, a launch, a funding attempt - each with its conversation and the open missions, resources and other objects that have formed out of it. Use it to see what is already in motion before starting something new. Members only.
projectId string requiredReturns a link or a proposal, or saves a draft that binds nobody. People approve on the site.
navigateToPageToolTurn a 1lev1.com page into a link to give the user - it does not open anything by itself. Pass the path (e.g. "/lev", or "/moach/<projectId>" with idPr) and a short name for it; the result carries the path to put after https://1lev1.com. getSitePagesTool lists the valid paths.
url string requiredpageName string requiredidPr string optionalcreateProjectToolPrepare the "create a Partnership" form (a Partnership is also called a rikma, or "רקמה") and return a link that opens it pre-filled. Nothing is created yet: status is "prepared" until the user opens the link and approves the form. Give the user `url` exactly as returned — do not decode, shorten or rebuild it. A public-benefit or nonprofit initiative is a normal Partnership, not a failed business: every Partnership has a public support page (/project/<id>/support) where anyone can donate to it or fund a specific mission, so the public can cover the members' work hours even when nothing is ever sold.
name string requireddesc string optionaldetails string optionalurl string optionalvals string[] optionalres "feh" | "sth" | "nsh" | "sevend" optionalprofit "already" | "week" | "month" | "threeM" | "sixM" | "oneY" | "twoY" | "more" | "never" optionalont boolean optionalprepareMissionToolPrepare the mission creation form and return a link that opens it pre-filled. Use this when the user should review and confirm the mission before it is published. A mission is for work that needs an implementer to be found. If a mission in progress already covers the work, create a task (act) on it with createTaskTool instead. Check the rikma's open missions (getProjectDetailsTool) first: when one already covers the work, point the user to it rather than preparing a duplicate. Mission names are also entries in a platform-wide catalogue where each name is unique; publishing a name that is already there reuses that catalogue entry automatically (the rikma's mission keeps its own description, hours and rate), so never rename a mission just to make it unique. Nothing is created yet: status is "prepared" until the user opens the link and publishes. Give the user `url` exactly as returned — do not decode, shorten or rebuild it. Requires a projectId - use findUserProjects first if not known.
projectId string requiredname string requireddescrip string optionalskills string[] optionalroles string[] optionalworkways string[] optionalnhours number optionalvalph number optionalplanProjectWorkToolTurn a free-text brief into a planning board for a project: proposed missions, chores (acts) and resources, deduplicated against what the project already has. Nothing is created - the tool returns a reviewUrl where the user approves each row in the real form. Use this when the user describes something they want the project to achieve in loose words. If the conversation already holds a concrete breakdown (tasks, scope, decisions), use createPlanBoardTool instead - it saves your rows as written. Requires a projectId (use findUserProjectsTool first if unknown). On failure, `error.retryable` says whether calling again can help.
projectId string requiredtext string requiredtitle string optionalcreatePlanBoardToolCreate a planning board from rows YOU already structured. Use this when the conversation already holds the breakdown - decisions, scope, a task list: your rows are saved as written, with no second model rewriting or dropping them. Nothing is created - every row is a proposal the user approves in the real creation form at the returned reviewUrl. Every row needs a name AND a descrip; rows without one are not saved and come back in `rejected`. Use planProjectWorkTool instead when the user only has a loose idea in free text. Requires a projectId. On failure, `error.retryable` says whether calling again can help.
projectId string requiredtitle string requireddescrip string optionalitems object[] requiredscanProjectDirectionsToolCheaply scan a project's real current state and propose a few DIRECTIONS for advancing it - strategic angles, not task lists. Use this when the user asks something open-ended like "what should we do next?" or "how do we move this forward?" and has not described a specific goal. These are saved as suggested directions only: nothing is created, and no mission, chore or resource comes out of this call. To break one direction down into concrete missions and resources afterwards, the user opens it on the returned reviewUrl and approves each row there. Requires a projectId. On failure, `error.retryable` says whether calling again can help.
projectId string requiredChanges only your own records - your timers, your profile, your drafts.
timerActionToolPerform actions on user timers (start, stop, pause, resume)
action "start" | "stop" | "pause" | "resume" requiredmissionId string optionalLands something on another member that still waits for that member's approval.
proposeProjectLinkToolSet or clear one of a rikma's links - its website, GitHub repo, Drive, Discord, Facebook, X or WhatsApp. In a rikma with more than one member, changing the website or the Facebook link opens a decision the members vote on (silence approves it when the rikma clock runs out); the other links change directly. Members only. Check listProjectResourcesTool first - the link may already be there.
projectId string requiredkind "website" | "github" | "drive" | "discord" | "facebook" | "x" | "whatsapp" requiredurl string requiredcreateTaskToolCreate a task (Act, "מטלה") in a project - the way a member gets something new done. Whenever the user wants something new to happen in a project, offer this option. Choose the shape: - A mission in progress already covers the work: create an act linked to it - assignedUserId = the mission holder, missionId from getMemberMissionsTool. - Nobody in the project does this kind of work, so an implementer must be found: this is not an act - prepare a mission with prepareMissionTool. - No specific person yet: create the act with no assignee and pass tafkidims = the roles that fit it (IDs from getProjectMembersTool). The holders of those roles are notified and one of them picks it up. An act assigned to another person waits for that person to approve it; nobody is bound until they accept. The caller must be a member of the project. Requires a project ID.
projectId string requiredname string requireddescription string optionallink string optionalassignedUserId string optionaltafkidims string[] optionalmissionId string optionalhashivut "white" | "green" | "yellow" | "red" optionaldateS string optionaldateF string optionalVisible to others under your name, and binds nobody.
postConversationMessageToolPost a message, as the user, in a conversation (forum) they take part in - an update on a mission, an answer in a decision thread, a note on a profit split. The other participants are notified. Use it ONLY when the user asked to say or record something; never to think out loud, and never to agree or refuse on their behalf (approving a decision, a split or a proposal is always their own click). The message is marked as written through an agent.
forumId string requiredmessage string requiredopenRikmaConversationToolGet the rikma's own general conversation - the one thread that belongs to the whole rikma rather than to a single mission, act or decision. It is created the first time someone opens it. Use it for "what are we doing next" talk; anything about a specific mission, decision or profit split belongs in that thing's own thread, where it stays on record. Returns a forumId for readConversation and postConversationMessage. Members only.
projectId string requiredstartProcessToolStart a process in a rikma: a named thread with its own conversation, for something that is not yet a mission or a resource - approaching an organisation, preparing a launch, chasing funding. The description becomes the first message, so a half-formed idea can be written in plain words and take shape later: as it becomes concrete, the open missions and resources it needs are created in the normal way and attached with attachToProcess. Members only. Use it when the user wants to record something the rikma is pursuing, not to file your own notes.
projectId string requiredname string requireddescription string optionalattachToProcessToolAttach an existing object - an open mission, an open resource, a mission in progress, or a mission/resource still being voted on - to a process, so what the rikma is pursuing and what it is actually doing about it stay connected. It does not create the object: create it first (prepareMissionTool, createTaskTool, or the URL the tool returns), then attach it.
projectId string requiredprocessId string requiredentityType "openMission" | "openMashaabim" | "mesimabetahalich" | "maap" | "pendm" | "pmash" requiredentityId string requiredname string optional