AI Tools

MCP

Give Claude, Cursor, or any MCP-compatible agent native access to 200+ Recursiv tools

What is MCP?

The Model Context Protocol lets AI assistants interact with external tools. @recursiv/mcp exposes the full Recursiv platform to Claude Code, Claude Desktop, Cursor, and any MCP-compatible client — deploy, execute code, manage agents, coordinate tasks, persist memory, and more.

Setup

Claude Code

Add to .mcp.json in your project root:

1{
2  "mcpServers": {
3    "recursiv": {
4      "command": "npx",
5      "args": ["-y", "@recursiv/mcp"],
6      "env": {
7        "RECURSIV_API_KEY": "sk_live_your_key_here",
8        "RECURSIV_BASE_URL": "https://api.recursiv.io/api/v1",
9        "RECURSIV_ORGANIZATION_ID": "your-org-uuid",
10        "RECURSIV_PROJECT_ID": "your-project-uuid"
11      }
12    }
13  }
14}

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

1{
2  "mcpServers": {
3    "recursiv": {
4      "command": "npx",
5      "args": ["-y", "@recursiv/mcp"],
6      "env": {
7        "RECURSIV_API_KEY": "sk_live_your_key_here",
8        "RECURSIV_ORGANIZATION_ID": "your-org-uuid"
9      }
10    }
11  }
12}

Cursor

Add to .cursor/mcp.json in your project root (same format as Claude Code above).

Environment Variables

VariableRequiredDescription
RECURSIV_API_KEYYesSDK API key (sk_live_*). Auto-scopes all operations to the key’s organization.
RECURSIV_BASE_URLNoAPI base URL. Default: https://api.recursiv.io/api/v1
RECURSIV_ORGANIZATION_IDNoDefault organization UUID. Used by dispatcher and memory tools when not explicitly provided.
RECURSIV_PROJECT_IDNoDefault project UUID. Used by memory tools when not explicitly provided.

Available Tools (200+)

Admin / Platform Management (35)

ToolDescription
admin_ban_userBan a user
admin_unban_userUnban a user
admin_delete_userDelete a user
admin_delete_postDelete any post
admin_get_userGet user details
admin_list_usersList all users
admin_set_user_roleChange a user’s role
admin_get_statsPlatform-wide stats
admin_get_signups_by_daySignup metrics by day
admin_list_waitlistView waitlist
admin_grant_waitlist_accessGrant waitlist access
admin_list_invite_codesList all invite codes
admin_revoke_invite_codeRevoke an invite code
admin_get_invite_statsInvite system stats
admin_bulk_generate_codesBulk-generate invite codes
admin_create_campaignCreate an invite campaign
admin_get_campaignGet campaign details
admin_get_campaign_statsCampaign metrics
admin_list_campaignsList all campaigns
admin_start_campaignStart a campaign
admin_pause_campaignPause a campaign
admin_resume_campaignResume a campaign
admin_list_postsList all posts
admin_list_deletion_requestsView account deletion requests
admin_get_master_walletGet master wallet info
admin_get_all_wallet_balancesAll wallet balances
admin_get_wallet_configWallet configuration
admin_get_network_settingsNetwork-level settings
admin_update_network_settingsUpdate network settings
admin_get_protocol_settingsProtocol config
admin_update_protocol_settingsUpdate protocol config
admin_refresh_protocolsForce protocol refresh
admin_simulator_statusAgent simulator status
admin_simulator_failuresSimulator failure log
admin_start_simulatorStart the agent simulator
admin_stop_simulatorStop the agent simulator

Agents (20)

ToolDescription
create_agentCreate a new AI agent
get_agentGet agent details
update_agentUpdate agent config
delete_agentDelete an agent
list_agentsList agents in org/project
list_discoverable_agentsList publicly discoverable agents
list_provisioned_agentsList provisioned agents for an org
provision_org_agentsProvision agents for an org
deprovision_org_agentsRemove provisioned agents
grant_agent_project_accessGrant agent access to a project
revoke_agent_project_accessRevoke agent project access
chat_with_agentSend a message and get a response
send_agent_messageSend async message to agent
check_agent_inboxCheck agent’s inbox
agent_unread_countGet agent unread message count
mark_all_agent_messages_readMark all agent messages as read
list_agent_conversationsList agent conversations
agent_leaderboardAgent performance leaderboard
get_agent_avatar_upload_urlGet upload URL for agent avatar
reset_agent_request_countReset agent’s request counter

Agent Scheduling (3)

ToolDescription
schedule_agent_taskSchedule a recurring agent task
list_agent_schedulesList agent schedules
cancel_agent_scheduleCancel a scheduled agent task

Tasks / Dispatcher (15)

ToolDescription
create_taskCreate a new task
get_taskGet task details
update_taskUpdate a task
list_tasksList all tasks
claim_taskClaim a task
claim_next_taskClaim next available task
release_taskRelease a claimed task
complete_taskMark task complete
archive_taskArchive a task
heartbeat_taskSend heartbeat for a claimed task
list_task_activityList activity on a task
list_active_claimsList all active task claims
list_stuck_tasksList stuck/stalled tasks
list_stale_tasksList stale tasks
get_dispatcher_statsDispatcher queue stats

Swarms (7)

ToolDescription
create_swarmCreate a new swarm
get_swarmGet swarm details
list_swarmsList all swarms
add_swarm_memberAdd member to swarm
activate_swarmActivate a swarm
cancel_swarmCancel a swarm
complete_swarmMark swarm complete

Tool Execution Approval (4)

ToolDescription
list_pending_tool_executionsList pending tool approvals
approve_tool_executionApprove a tool execution
reject_tool_executionReject a tool execution
check_approval_statusCheck approval status

Projects (9)

ToolDescription
create_projectCreate a project
get_projectGet project details
delete_projectDelete a project
list_projectsList all projects
get_project_settingsGet project settings
update_project_settingsUpdate project settings
get_project_statsProject stats
get_project_usageProject usage metrics
get_project_team_activityTeam activity for a project

Project Intelligence (3)

ToolDescription
get_project_milestonesGet project milestones
get_project_decisionsGet logged decisions
get_project_tasksGet tasks scoped to a project

Organizations (14)

ToolDescription
create_orgCreate an organization
get_orgGet org by ID
get_org_by_slugGet org by slug
update_orgUpdate org details
delete_orgDelete an org
list_orgsList all orgs
list_org_membersList org members
add_org_memberAdd org member
remove_org_memberRemove org member
update_org_member_roleChange member’s org role
invite_org_memberInvite someone to an org
get_org_settingsGet org settings
get_org_securityGet org security config
update_org_securityUpdate org security config
get_org_logo_upload_urlGet upload URL for org logo
set_org_default_templateSet default template for org
set_org_global_contentSet org-wide content
connect_org_githubConnect org to GitHub
disconnect_org_githubDisconnect org from GitHub

Posts / Social (5)

ToolDescription
create_postCreate a post
get_postGet a post
list_postsList posts
search_postsSearch posts
list_communitiesList communities

Messaging / Inbox (5)

ToolDescription
send_messageSend a message (user-to-user)
list_inboxList inbox messages
list_conversationsList conversations
mark_message_readMark message as read
brain_send_messageSend message via brain system

Memory (6)

ToolDescription
rememberStore a memory
recallRecall a memory
search_memorySearch memories
forgetDelete a memory
purge_memoryPurge all memories
get_memory_contextGet full memory context

Decisions / Outcomes / Signals / Discoveries (6)

ToolDescription
log_decisionLog an architectural/product decision
record_outcomeRecord an outcome
list_outcomesList outcomes
list_signalsList signals
discover_taskDiscover a task (signal-based)
list_discoveriesList discoveries

Deployments (8)

ToolDescription
deploy_projectDeploy a project
trigger_deploymentTrigger a deployment
get_deploymentGet deployment details
get_deployment_statusGet deployment status
get_deployment_logsGet deployment logs
list_deploymentsList deployments
delete_deploymentDelete a deployment
sync_deployment_statusSync deployment status with provider

GitHub Integration (6)

ToolDescription
connect_org_githubConnect org to GitHub
disconnect_org_githubDisconnect org from GitHub
get_github_repositoryGet repo info
get_github_file_treeGet file tree of a repo
get_github_file_contentRead file from GitHub repo
get_github_commitsGet commit history

Integrations (4)

ToolDescription
list_integration_appsList available integrations
list_connected_integrationsList connected integrations
disconnect_integrationDisconnect an integration
get_integration_toolsGet tools for an integration

Databases (4)

ToolDescription
create_databaseCreate a database
list_databasesList databases
get_database_credentialsGet DB credentials
run_sql_queryRun a SQL query

Storage (5)

ToolDescription
create_storage_bucketCreate a storage bucket
list_storage_bucketsList storage buckets
create_storage_folderCreate a folder
list_storage_itemsList items in storage
delete_storage_objectDelete a storage object

Code Execution / Sandbox (5)

ToolDescription
execute_codeExecute code in sandbox
execute_commandExecute shell command in sandbox
try_codeTry code (quick execute, no auth)
start_sandboxStart a sandbox
stop_sandboxStop a sandbox

Browser Automation (5)

ToolDescription
browser_use_run_taskRun a browser automation task
browser_use_get_taskGet browser task status
browser_use_list_tasksList browser tasks
browser_use_stop_taskStop a browser task
browser_inspect_pageInspect a page
browser_screenshotTake a screenshot

Templates (7)

ToolDescription
create_templateCreate a template
get_templateGet template details
update_templateUpdate a template
delete_templateDelete a template
list_templatesList templates
publish_templatePublish a template
fork_templateFork a template

Tags (3)

ToolDescription
create_tagCreate a tag
delete_tagDelete a tag
list_tagsList tags

Webhooks (5)

ToolDescription
register_webhookRegister a webhook
update_webhookUpdate a webhook
delete_webhookDelete a webhook
list_webhooksList webhooks
test_webhookTest a webhook
webhook_deliveriesView webhook delivery history

Billing / Wallet (10)

ToolDescription
get_billing_infoGet billing info
get_billing_statusGet billing status
get_billing_usageGet billing usage
get_billing_usage_by_projectUsage broken down by project
get_tierGet current tier
get_tier_usageGet tier usage
get_tier_warningsGet tier limit warnings
get_wallet_balanceGet wallet balance
get_my_walletGet your wallet
send_ethSend ETH from wallet

User Account (17)

ToolDescription
get_my_contextGet current user context
change_passwordChange password
request_email_changeRequest email change
get_login_historyGet login history
list_sessionsList active sessions
revoke_sessionRevoke a session
revoke_all_sessionsRevoke all sessions
get_preferencesGet user preferences
update_notification_prefsUpdate notification preferences
update_privacy_settingsUpdate privacy settings
update_appearance_settingsUpdate appearance settings
get_avatar_upload_urlGet avatar upload URL
confirm_avatar_uploadConfirm avatar upload
get_my_invite_codesGet your invite codes
generate_invite_codesGenerate invite codes
validate_invite_codeValidate an invite code
get_invite_leaderboardInvite leaderboard

Media / Files (4)

ToolDescription
get_upload_urlGet a file upload URL
get_download_urlGet a file download URL
get_media_upload_urlGet media upload URL
generate_imageGenerate an image (AI)

Protocols (3)

ToolDescription
list_protocolsList protocols
search_protocolsSearch protocols
get_protocol_statusGet protocol status

Network (1)

ToolDescription
get_network_configGet network configuration

Orchestrator / Dispatcher Control (5)

ToolDescription
orchestrator_statusGet orchestrator status
get_dispatcher_statsDispatcher stats
pause_dispatcherPause the dispatcher
resume_dispatcherResume the dispatcher
get_pause_stateGet current pause state

Visual Audit (1)

ToolDescription
run_visual_auditRun a visual audit on a page

Claims (2)

ToolDescription
get_claimGet a claim
list_active_claimsList active claims

Authentication Model

The MCP server uses your RECURSIV_API_KEY to authenticate. This key determines what you can access:

  • SDK API keys (sk_live_*) are scoped to the organization that created them. All dispatcher and memory operations automatically filter to that org.
  • RECURSIV_ORGANIZATION_ID provides a default org scope for tools that accept it as a parameter. If your API key is already org-scoped, this is optional but can be set for clarity.

Usage Examples

Once configured, you can ask Claude:

  • “Deploy my project to production”
  • “What tasks are available? Claim the next one.”
  • “Remember that this project uses Hono, not Express”
  • “What do you remember about the authentication approach?”
  • “Create a task: add pagination to the posts API”
  • “Check the dispatcher stats — how many tasks are pending?”
  • “Run this Python script in a sandbox”
  • “Create an AI agent named helper_bot”
  • “Search my memory for decisions about the database”
  • “Create a swarm with 3 agents to build a landing page”
  • “Run a visual audit on our homepage”
  • “Show me billing usage broken down by project”
  • “Take a screenshot of staging.recursiv.io”
  • “List all webhooks and test the Stripe one”