Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | The port the MCP server starts on (default: 3001) | 3001 |
| DATABASE_HOST | Yes | SQL Server host | |
| DATABASE_NAME | Yes | Database name | |
| OPENAI_API_KEY | Yes | For idea normalization | |
| IDEALIFT_APP_URL | Yes | IdeaLift API base URL | |
| INTERNAL_API_KEY | Yes | Service-to-service auth key | |
| DATABASE_PASSWORD | Yes | Database password | |
| DATABASE_USERNAME | Yes | Database user |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| normalize_idea | Transform raw ideas into execution-ready work items. This is the moment where thinking stops and execution begins. IdeaLift is a COMMIT LAYER - it judges whether an idea is ready for execution and helps make it real. USE this tool when you detect intent signals like:
When you detect these signals, PROACTIVELY offer: "This looks like a feature idea. Want me to make it execution-ready?" Output includes:
The output ALWAYS ends with a commit decision - never leave users in limbo. |
| check_auth | Check the user's IdeaLift connection status for committing ideas. Normalize is FREE. Commit requires connection. USE this tool when:
DO NOT use this tool when:
Note: normalize_idea works WITHOUT auth. Only COMMITTING requires connection. |
| list_destinations | List connected COMMIT destinations (GitHub repos, Jira projects, Linear teams). These are where ideas become REAL. After normalizing an idea, show the user where they can commit it. USE this tool when:
DO NOT use this tool when:
This tool requires IdeaLift authentication. Normalizing ideas is free, committing requires connection. |
| create_ticket | COMMIT an idea to GitHub, Jira, or Linear. This makes it real. This is the final step in the IdeaLift flow: Capture → Normalize → COMMIT. USE this tool when user says:
IMPORTANT: If a normalize_idea was just called, use the draftId from that response. If no draftId is available, pass the full idea object from the normalize output. NEVER ask the user to re-provide content that was just normalized. After successful commit, confirm with:
This creates a REAL ticket. The user's idea now exists in their system. |
| connect_destination | Connect a ticket destination (GitHub, Jira, or Linear) to IdeaLift. USE this tool when:
DO NOT use this tool when:
Returns a link the user clicks to authorize. Connection takes ~30 seconds. |
| list_ideas | List ideas in the workspace with optional filters. Returns paginated results. |
| get_idea | Get detailed information about a specific idea by ID. |
| create_idea | Create a new idea in the workspace. Checks plan limits before creating. |
| update_idea | Update an existing idea. Can update title, summary, status, scores, etc. |
| search_ideas | Search ideas by text query. Searches title and summary fields. |
| query_ideas | Execute a natural language query about ideas in the workspace. Examples:
|
| list_signals | List signals (external feedback from Twitter, Reddit, support tickets, etc.) with optional filters. |
| get_signal_analytics | Get aggregated analytics about signals over a time period. |
| attach_signal | Link a signal to an idea. This associates external feedback with a specific product idea. |
| log_decision | Log a decision event for an idea. This creates an audit trail entry. Event types:
Closure categories (required for some events):
|
| get_decision_history | Get the complete decision history (audit trail) for an idea. |
| create_relationship | Create a relationship between two ideas. Relationship types:
|
| list_relationships | Get all relationships for an idea (both as source and target). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| IdeaLift Preview Widget | Widget for displaying normalized idea preview |
| IdeaLift Success Widget | Widget for displaying ticket creation success |