MCP Tools

Complete reference for Astralform MCP tools available in Claude Code.

Overview

The plugin exposes 58 MCP tools that Claude can use to manage your Astralform projects. These are invoked automatically when you ask Claude to perform Astralform operations.

Authentication

Authentication is automatic via MCP OAuth — Claude Code handles it when you first use any tool.

Tool	Description
astralform_whoami	Get current developer profile
astralform_get_stats	Get aggregate account statistics

Teams

Tool	Description
astralform_list_teams	List all teams you belong to
astralform_get_team	Get team details by ID
astralform_create_team	Create a new team with name and slug
astralform_list_team_members	List members and their roles in a team

Example: List Teams

Show me my Astralform teams

Claude will call astralform_list_teams and display your teams with roles.

Projects

Tool	Description
astralform_list_projects	List all your projects (includes team info)
astralform_get_project	Get project details by ID (includes team_id)
astralform_create_project	Create a new project under a team (requires team_id)
astralform_update_project	Update project name
astralform_delete_project	Delete a project

Example: Create Project

Create a new Astralform project called "My AI Assistant" under my startup team

Claude will select the team, call astralform_create_project with the team_id, and return the project ID and encryption key.

API Keys

Tool	Description
astralform_list_api_keys	List API keys (prefix only for security)
astralform_create_api_key	Generate a new API key
astralform_revoke_api_key	Revoke an existing key

Full API keys are shown only once at creation. Store them securely.

LLM Configuration

Tool	Description
astralform_list_llm_providers	List available providers (OpenAI, Anthropic, Groq, Ollama)
astralform_get_llm_config	Get current LLM configuration
astralform_set_llm_config	Set LLM provider and model
astralform_delete_llm_config	Remove LLM configuration

Example: Configure LLM

Set up Claude claude-sonnet-4-20250514 for my project

Claude will call astralform_set_llm_config with the appropriate provider and model.

Search Settings

Tool	Description
astralform_get_search_settings	Get web search configuration
astralform_set_search_settings	Configure search provider, max results, API key

Example: Enable Search

Enable web search for my project using Tavily

Claude will call astralform_set_search_settings with the provider and API key.

Memory Settings

Tool	Description
astralform_get_memory_settings	Get memory configuration
astralform_set_memory_settings	Configure retrieval, extraction, limits

Example: Enable Memory

Enable memory for my project with 10 memories per turn

Guard Rails

Tool	Description
astralform_get_guardrails_settings	Get guard rails configuration
astralform_set_guardrails_settings	Configure PII detection and execution limits

Example: Enable PII Detection

Enable PII detection for my project to redact emails and credit cards

Environment Variables

Tool	Description
astralform_list_envs	List environment variable keys (values never exposed)
astralform_set_env	Set or update an environment variable (encrypted at rest)
astralform_delete_env	Delete an environment variable

Example: Set Env Var

Set TAVILY_API_KEY for my project

Values are encrypted at rest and never returned in responses. Cannot delete vars required by skills assigned to agents.

Marketplace

Tool	Description
astralform_browse_marketplace	Browse and search the skill marketplace
astralform_install_marketplace_skill	Install a skill from marketplace URL

Example: Browse Skills

Search the marketplace for PDF processing skills

Skills

Tool	Description
astralform_list_skills	List skills configured for a project
astralform_get_skill	Get skill details including content
astralform_create_skill	Create a skill with custom SKILL.md content
astralform_create_skill_from_url	Import a skill from a URL
astralform_update_skill	Update a skill’s content
astralform_delete_skill	Delete a skill from a project
astralform_toggle_skill	Enable/disable a skill
astralform_refresh_skill	Refresh a URL-sourced skill

Example: Add a Skill

Add a customer support skill to my project that handles refunds and escalations

Claude will call astralform_create_skill with appropriate SKILL.md content.

Example: Import from GitHub

Import the PDF processing skill from https://raw.githubusercontent.com/example/skills/main/pdf/SKILL.md

Agents

Tool	Description
astralform_list_agents	List agents configured for a project
astralform_get_agent	Get agent details including resource assignments
astralform_create_agent	Create a new agent with name, LLM, and resources
astralform_update_agent	Update an agent’s configuration or resources
astralform_delete_agent	Delete an agent (cannot delete default)
astralform_toggle_agent	Enable/disable an agent

Example: Create an Agent

Create a support agent for my project that handles customer inquiries, assign it the customer-faq skill

Claude will call astralform_create_agent with the name, description, and skill assignments.

Connectors

Tool	Description
astralform_list_connectors	List available connectors (Slack, Notion, GitHub)
astralform_get_connector	Get connector details by slug
astralform_list_project_connectors	List connectors enabled for a project
astralform_enable_connector	Enable a connector with credentials
astralform_update_project_connector	Update connector configuration
astralform_disable_connector	Remove a connector (revokes user tokens)

Example: Enable Slack

Enable Slack connector for my project with client ID xxx and client secret yyy

Claude will call astralform_enable_connector with the OAuth credentials.

Example: List Connectors

What connectors are available for Astralform?

Claude will call astralform_list_connectors and show the catalog with tool counts.

Analytics

Tool	Description
astralform_get_analytics	Get detailed usage analytics for a project

Provider Keys

Tool	Description
astralform_list_provider_keys	List stored model provider API keys
astralform_set_provider_key	Store an API key for a provider (OpenAI, Anthropic, etc.)
astralform_delete_provider_key	Remove a stored provider key
astralform_test_provider_key	Test that a stored provider key is valid

Example: Store Provider Key

Save my OpenAI API key sk-xxx for Astralform

Claude will call astralform_set_provider_key to securely store the key.

Capsule

Tool	Description
astralform_list_capsule_sessions	List sandbox sessions for a project
astralform_get_capsule_stats	Get capsule usage statistics

Documentation

Tool	Description
astralform_search_docs	Search Astralform documentation
astralform_get_doc	Get full documentation page

Example: Search Docs

How do I handle client tools in Astralform?

Claude will search the docs and provide relevant information.