Environment Variables

When Pickaxe runs an Action or MCP server, it injects runtime context as environment variables.

Core Context

• PICKAXE_FORM_ID: the Pickaxe ID.
• PICKAXE_RESPONSE_ID: the current session or conversation ID.
• PICKAXE_USER_IDENTIFIER: the end-user identifier for the current run.
• PICKAXE_USER_EMAIL: the resolved end-user email when available.

Knowledge And File Context

• PICKAXE_END_USER_DOC_URLS: JSON-encoded array of end-user document URLs.
• PICKAXE_END_USER_RAW_DOC_URLS: JSON-encoded array of raw or original end-user document URLs.
• PICKAXE_END_USER_IMAGE_URLS: JSON-encoded array of image URLs available to the run.

Additional Image Context

• PICKAXE_CURRENT_REQUEST_IMAGE_URLS: JSON-encoded array of images attached in the current request.
• PICKAXE_SESSION_IMAGE_URLS: JSON-encoded array of image URLs seen earlier in the session.
• PICKAXE_PRIMARY_IMAGE_URL: the first available image URL for the run, or an empty string if none exists.

User And Frontend Context

• PICKAXE_END_USER_PAID: string value "True" or "False" indicating whether the user is paid.
• PICKAXE_FRONTEND_PICKAXE_CONFIG: JSON-encoded frontend metadata or config for the current Pickaxe session.
• PICKAXE_USER_MEMORIES: JSON-encoded array of formatted memory strings when user memories are available.

Examples

const docUrls = JSON.parse(process.env.PICKAXE_END_USER_DOC_URLS || "[]");
const rawDocUrls = JSON.parse(process.env.PICKAXE_END_USER_RAW_DOC_URLS || "[]");
const imageUrls = JSON.parse(process.env.PICKAXE_END_USER_IMAGE_URLS || "[]");
const userMemories = JSON.parse(process.env.PICKAXE_USER_MEMORIES || "[]");

console.log("Pickaxe ID:", process.env.PICKAXE_FORM_ID);
console.log("Session ID:", process.env.PICKAXE_RESPONSE_ID);
console.log("User Identifier:", process.env.PICKAXE_USER_IDENTIFIER);
console.log("Paid User:", process.env.PICKAXE_END_USER_PAID);
console.log("Primary Image URL:", process.env.PICKAXE_PRIMARY_IMAGE_URL);
console.log("Docs:", docUrls);
console.log("Memories:", userMemories);

Important Notes

• Several values above are JSON-encoded strings, not native arrays or objects. Actions and MCP servers should parse them before use.
• Prompt injectors and environment variables are different systems. Prompt injectors perform string replacement inside the Pickaxe prompt. Environment variables are injected into Action and MCP execution environments.