v0.3.0

Give your AI assistant
direct access to AMPLIS

The AMPLIS MCP Server connects Claude, Cursor, and other AI tools to your live consulting data — projects, people, clients, timesheets, and more.

Get Started API Reference

Tools

Create tasks, log time, manage clients, search knowledge, track credentials, and more — all through natural language.

Resources

16 static feeds and 20 parameterized templates for real-time access to projects, people, pipeline, invoices, and files.

Prompts

Pre-built prompt templates for weekly status, project health, compliance checks, invoice drafts, and more.

Getting Started

1. Install

Terminal

# Run directly with npx
npx @amplis/mcp-server

# Or install globally
pnpm add -g @amplis/mcp-server

2. Authenticate

Run the login command — your browser will open for secure authentication via your AMPLIS account:

Terminal

# Browser-based login (recommended)
npx @amplis/mcp-server login

# Or paste an API key manually
npx @amplis/mcp-server login-key

# Check your authentication status
npx @amplis/mcp-server status

# Remove stored credentials
npx @amplis/mcp-server logout

The browser login flow opens app.amplis.com.au, authenticates you via your AMPLIS account, and securely exchanges an authorization code for an API key. No manual key copying required.

Credentials are stored securely at ~/.amplis/credentials.json with 0600 permissions. Alternatively, generate an API key in the AMPLIS web app under Settings → API Keys and use login-key to paste it.

3. Configure Your AI Tool

Add the AMPLIS MCP server to your AI tool of choice. Below are configs for the most common tools:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

claude_desktop_config.json

{
  "mcpServers": {
    "amplis": {
      "command": "npx",
      "args": ["@amplis/mcp-server"]
    }
  }
}

Claude Code (CLI)

Terminal

claude mcp add amplis npx @amplis/mcp-server

Cursor

Add to .cursor/mcp.json in your project root:

.cursor/mcp.json

{
  "mcpServers": {
    "amplis": {
      "command": "npx",
      "args": ["@amplis/mcp-server"]
    }
  }
}

Environment Variables

These are optional — the CLI login flow is the recommended approach. Environment variables override stored credentials when set.

Variable	Description
AMPLIS_ORG_ID	Organization ID (overrides credentials file)
AMPLIS_USER_ID	User ID for audit logging
AMPLIS_API_URL	API base URL (default: https://app.amplis.com.au)

Tools Reference

35 tools grouped by domain. Your AI assistant calls these to read and write data in AMPLIS.

Task Management 3 tools

task_create

Create a new task in a project

projectId title description assigneeId dueDate priority

task_update

Update an existing task

taskId status assigneeId dueDate notes

task_search

Search tasks by status, assignee, project, or overdue

projectId status assigneeId overdue query

Time Tracking 2 tools

time_log

Log time against a project or task

projectId hours date taskId description category

timesheet_submit

Submit a timesheet period for approval

periodId

Projects 1 tool

project_search

Search projects by name, status, client, or lifecycle stage

query status clientId lifecycleStage

Clients 3 tools

client_search

Search clients by name or industry

query industry

client_create

Create a new client

name industry website description

client_update

Update an existing client

clientId name industry healthScore

People 1 tool

person_search

Search people by name, role, skill, or availability

query role skill available

Contacts 1 tool

contact_create

Create a new global contact

firstName lastName email phone role clientId

Pipeline 1 tool

pipeline_move

Move an opportunity to a different pipeline stage

opportunityId stage notes

Deliverables 2 tools

deliverable_create

Create a new deliverable in a project

projectId name type billingModel budgetHours

deliverable_update

Update an existing deliverable

deliverableId status percentComplete

Documents & Knowledge 3 tools

document_search

Search documents by name, type, or project

query type projectId

document_create

Create a new document

name type projectId personId

kb_search

Search the knowledge base using semantic search with pgvector

query projectId

Credentials 3 tools

credential_create

Create a new credential for a person

personId type name issuer expiresAt

credential_update

Update an existing credential

credentialId status expiresAt

credential_search

Search credentials across the organization

personId type status expiringWithinDays

Capabilities 3 tools

capability_add

Add a capability/skill to a person

personId category name proficiency yearsExperience

capability_update

Update an existing capability

capabilityId proficiency yearsExperience

capability_evidence_add

Add evidence supporting a capability claim

capabilityId type title projectId

Availability 3 tools

availability_set

Set availability for a person on a specific date

personId date status hours

availability_bulk_set

Set availability for multiple dates at once

personId entries

availability_query

Query availability for a person or team over a date range

startDate endDate personId status

Compliance 2 tools

site_visit_log

Log a site visit with findings and risks

projectId visitDate location findings risks

compliance_update

Update a compliance item (permit, license, etc.)

complianceId status expiryDate

Alerts & Notes 2 tools

alert_acknowledge

Acknowledge an alert

alertId notes

note_add

Add a note to a project, task, or client

entityType entityId content category

Memory & Decisions 5 tools

memory_store

Store a memory or observation about a project, client, or entity

entityType category content entityId

memory_recall

Recall memories about a specific entity

entityType entityId

memory_search

Search memories semantically across the organization

query entityType

decision_log

Log a decision with its rationale for future reference

title decision rationale projectId

meeting_summarize

Create a meeting note with auto-extracted action items and decisions

title date attendees rawNotes projectId

red = required parameter grey = optional parameter

Resources Reference

Resources provide read-only access to live data. Static resources return collections; templates accept parameters for detail views.

Static Resources

URI	Name	Description
amplis://projects	Projects	All projects with status, dates, and client
amplis://pipeline	Pipeline	Sales pipeline stages with counts and values
amplis://alerts	Alerts	Active alerts requiring attention
amplis://clients	Clients	All clients with industry and health score
amplis://people	People	Team members with role and allocation status
amplis://contacts	Contacts	All global contacts
amplis://documents	Documents	All documents (proposals, reports, resumes)
amplis://knowledge/sources	Knowledge Base	KB sources with status and chunk counts
amplis://credentials	Credentials	All credentials across the organization
amplis://capabilities/matrix	Capability Matrix	Full capability matrix for all people
amplis://team/availability	Availability	Team availability for the next 4 weeks
amplis://team/utilization	Utilization	Allocated hours and timesheet totals
amplis://timesheets	Timesheets	Current timesheet periods across the team
amplis://invoices	Invoices	All invoices with status and amounts
amplis://files	Files	All files and attachments
decisions://org	Decisions	Recent decisions across the organization

Resource Templates

URI Pattern	Name	Description
amplis://projects/{projectId}	Project Detail	Tasks, team, and deliverables
amplis://projects/{projectId}/tasks	Project Tasks	All tasks with assignees and status
amplis://projects/{projectId}/deliverables	Deliverables	Deliverables with status and progress
amplis://clients/{clientId}	Client Detail	Contacts, projects, and billing
amplis://people/{personId}	Person Detail	Credentials, capabilities, allocations
amplis://people/{personId}/credentials	Person Credentials	All credentials for a person
amplis://people/{personId}/capabilities	Person Capabilities	Skills and evidence for a person
amplis://people/{personId}/availability	Person Availability	Day-by-day availability
amplis://contacts/{contactId}	Contact Detail	Detailed contact information
amplis://documents/{documentId}	Document Detail	Metadata and version history
amplis://knowledge/search?q={query}	KB Search	Semantic search across knowledge base
amplis://credentials/expiring?days={days}	Expiring Credentials	Credentials expiring within N days
amplis://timesheets/{periodId}/entries	Timesheet Entries	All entries for a timesheet period
amplis://invoices/{invoiceId}	Invoice Detail	Detailed invoice with line items
amplis://files/{entityType}/{entityId}	Entity Files	Files attached to a specific entity
context://project/{projectId}	Project Context	Memories, decisions, and risks
context://client/{clientId}	Client Context	Preferences, history, and projects
decisions://project/{projectId}	Project Decisions	Decision history for a project
meetings://project/{projectId}	Project Meetings	Meeting notes for a project
memories://search?q={query}	Memory Search	Search all memories semantically

Prompts Reference

13 pre-built prompt templates that fetch live data and generate structured analysis. Pass them to your AI assistant as ready-to-use workflows.

weekly_status

Generate a weekly status report with real task, time, and deliverable data

projectId week

daily_standup

Daily standup summary with completed work, planned tasks, and blockers

userId date projectId

project_health

Analyze budget burn, timeline adherence, and risk exposure

projectId includeForecasts

meeting_prep

Prepare for a client meeting with recent activity and talking points

clientId projectId meetingType

compliance_check

Review compliance status and upcoming credential expirations

projectId daysAhead

resource_plan

Resource allocation recommendation with availability and capability data

projectId timeframe

risk_assessment

Assess risks using alerts, tasks, compliance, and agent memories

projectId

pipeline_review

Analyze pipeline health, stage distribution, and stale opportunities

stage

invoice_draft

Draft an invoice based on unbilled time entries for a client

clientId projectId fromDate toDate

client_update

Draft a client update email with recent activity and progress

clientId topic

handoff_notes

Generate handoff notes with tasks, decisions, and tribal knowledge

projectId fromUserId toUserId scope

capability_gap

Analyze capability matrix for gaps, single points of failure, and training needs

No parameters required

team_availability

Team calendar overview with availability, upcoming leave, and capacity

weeks

Security

API Key Format

Keys follow the format amplis_ followed by 64 hex characters (32 random bytes).

amplis_a1b2c3d4e5f6a7b8c9d0e1f2...

Storage & Hashing

API keys are never stored in plain text. Only the SHA-256 hash is persisted in the database. The full key is shown once at creation and cannot be retrieved again.

Local Credentials

Stored at ~/.amplis/credentials.json with strict file permissions: 0600 on the file, 0700 on the directory. The CLI warns if permissions are too open.

Permission Scopes

API keys support three permission levels:

read Read-only access to resources and data

write Create and update records via tools

admin Full access including key management

Key Rotation

Keys can be rotated atomically in the AMPLIS web app under Settings. Rotation creates a new key and revokes the old one in a single transaction, so there is no downtime. Keys also support optional expiration dates — set expiresAt when creating a key to enforce automatic expiry.

Ready to connect your AI to AMPLIS?

Get started with the MCP server or talk to us about how AI-powered consulting operations can transform your team.

Or email us directly at david.gibbon@amplis.com.au

Give your AI assistant direct access to AMPLIS

Getting Started

1. Install

2. Authenticate

3. Configure Your AI Tool

Environment Variables

Tools Reference

Resources Reference

Static Resources

Resource Templates

Prompts Reference

Security

API Key Format

Storage & Hashing

Local Credentials

Permission Scopes

Key Rotation

Ready to connect your AI to AMPLIS?

Give your AI assistant
direct access to AMPLIS