Documentation

Everything you need to set up Ascend and connect it to your AI workflow.

Getting Started

Ascend is a goal tracking system that connects daily actions to yearly ambitions. It organizes your goals into four levels (yearly, quarterly, monthly, weekly) so every small task contributes to your bigger picture.

You can use Ascend through the web app directly, or connect it to your favourite AI assistant through the Model Context Protocol (MCP). With MCP, your AI can create goals, log progress, check deadlines, and help you stay on track without ever leaving your coding environment or chat window.

MCP Integration

The Model Context Protocol (MCP) allows AI assistants to interact with Ascend programmatically. Once configured, your AI can create, update, and query your goals as part of your natural workflow.

API Key Required

To connect any AI tool to Ascend, you need an API key. You can find and copy your API key from the Settings page.

Claude Desktop

Open Settings → Developer → Edit Config, or directly edit the config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following to your config:

{
  "mcpServers": {
    "ascend": {
      "command": "npx",
      "args": ["-y", "ascend-goals-mcp"],
      "env": {
        "ASCEND_API_URL": "https://ascend.nativeai.agency",
        "ASCEND_API_KEY": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop after saving the config.

Claude Code CLI

Add the following to your ~/.claude.json file:

{
  "mcpServers": {
    "ascend": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ascend-goals-mcp"],
      "env": {
        "ASCEND_API_URL": "https://ascend.nativeai.agency",
        "ASCEND_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor IDE

Create .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "ascend": {
      "command": "npx",
      "args": ["-y", "ascend-goals-mcp"],
      "env": {
        "ASCEND_API_URL": "https://ascend.nativeai.agency",
        "ASCEND_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code + GitHub Copilot

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "ascend": {
      "command": "npx",
      "args": ["-y", "ascend-goals-mcp"],
      "env": {
        "ASCEND_API_URL": "https://ascend.nativeai.agency",
        "ASCEND_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ascend": {
      "command": "npx",
      "args": ["-y", "ascend-goals-mcp"],
      "env": {
        "ASCEND_API_URL": "https://ascend.nativeai.agency",
        "ASCEND_API_KEY": "your-api-key"
      }
    }
  }
}

Cline (VS Code Extension)

Open Cline Settings → MCP Servers tab → Add server, or edit cline_mcp_settings.json:

{
  "mcpServers": {
    "ascend": {
      "command": "npx",
      "args": ["-y", "ascend-goals-mcp"],
      "env": {
        "ASCEND_API_URL": "https://ascend.nativeai.agency",
        "ASCEND_API_KEY": "your-api-key"
      }
    }
  }
}

Gemini CLI

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "ascend": {
      "command": "npx",
      "args": ["-y", "ascend-goals-mcp"],
      "env": {
        "ASCEND_API_URL": "https://ascend.nativeai.agency",
        "ASCEND_API_KEY": "your-api-key"
      }
    }
  }
}

Note: Only Gemini CLI supports MCP. The Gemini web app does not support MCP yet.

ChatGPT Desktop

Coming Soon

ChatGPT Desktop supports remote MCP servers via Developer Mode (Settings → Connectors → Advanced). Ascend will provide a hosted remote MCP endpoint in a future update.

Requires ChatGPT Plus or Pro subscription.

Perplexity

Open Perplexity (web or desktop) → Settings → MCP Connectors → Add custom connector, then configure:

Name: Ascend
MCP server URL: https://ascend.nativeai.agency/api/mcp
Open the Advanced section
Authentication: select API Key or Bearer Token and paste your Ascend API key
Transport: Streamable HTTP
Check the confirmation checkbox and click Add

If you only see OAuth as an authentication option, Ascend does not support OAuth yet. In that case, select "None" for authentication and the connection will work for read operations. Full authenticated access is planned.

Manus

Coming Soon

Manus supports MCP through prebuilt connectors and custom MCP servers. Ascend integration for Manus is planned for a future release.