Skip to main content
This page documents every tool exposed by quikly-mcp-server. Each tool maps to a REST API endpoint — the MCP server handles authentication and request formatting for you.

​
quikly_me

Get the current authenticated user’s profile. API equivalent: GET /me Parameters: None Example usage:
“Check my Quikly profile”
Response: 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "dev@youragency.com",
  "name": "Alex Torres",
  "subscription_tier": "pro",
  "created_at": "2026-01-15T10:30:00Z"
}
Use this tool to verify the MCP connection is working and to check your subscription tier before creating proposals.

​
quikly_create_proposal

Create a new proposal with project details and requirements. API equivalent: POST /proposals Parameters:
​
project_name
string
required
Name of the project (e.g., “E-commerce Platform - Acme Corp”).
​
client_name
string
Name of the client or company.
​
requirements
array
List of requirements. Each requirement is an object with:
​
hourly_rate
number
required
Your hourly rate for this project.
​
currency
string
default:"USD"
Currency code (e.g., USD, EUR, ARS).
Example usage:
“Create a proposal for Acme Corp’s e-commerce platform. Requirements: user auth (complexity 5, high priority), product catalog (complexity 8, high), shopping cart (complexity 5, medium), checkout with Stripe (complexity 5, high). My rate is $85/hour USD.”
Response: Full proposal object including id, calculated totals, estimated days, and all settings.

​
quikly_analyze_brief

Analyze a raw project brief and extract structured requirements using AI. API equivalent: POST /ai/analyze-brief Parameters:
​
brief
string
required
The project brief text. Can be a formal document, meeting notes, an email, or even a messy Slack thread.
​
language
string
default:"en"
Language for the output: en or es.
Example usage:
“Analyze this brief: ‘We need a mobile app for our restaurant chain. Customers should be able to browse the menu, place orders for pickup or delivery, pay with Apple Pay or credit card, and earn loyalty points. We have 45 locations across Texas. Need to integrate with our existing Square POS system. Launch target is Q3 2026.’”
Response: 
{
  "success": true,
  "requirements": [
    {
      "id": "req_1",
      "name": "Menu browsing",
      "description": "Customers browse restaurant menu with categories, item details, photos, and dietary filters.",
      "complexity": 3,
      "priority": "high",
      "rationale": "Core feature — primary interaction point for all users."
    },
    {
      "id": "req_2",
      "name": "Order placement (pickup & delivery)",
      "description": "Place orders for pickup or delivery with location selection across 45 locations, estimated times, and order tracking.",
      "complexity": 8,
      "priority": "high",
      "rationale": "Multi-location delivery adds complexity for routing and availability."
    },
    {
      "id": "req_3",
      "name": "Payment processing",
      "description": "Apple Pay and credit card payments with tokenized processing and PCI compliance.",
      "complexity": 5,
      "priority": "high",
      "rationale": "Payment is critical path. Apple Pay integration adds native SDK work."
    },
    {
      "id": "req_4",
      "name": "Loyalty program",
      "description": "Points-based loyalty system with earning rules, redemption, and tier levels.",
      "complexity": 5,
      "priority": "medium",
      "rationale": "Drives retention but can launch with basic version."
    },
    {
      "id": "req_5",
      "name": "Square POS integration",
      "description": "Two-way sync with Square POS for menu, orders, and inventory across 45 locations.",
      "complexity": 8,
      "priority": "high",
      "rationale": "Third-party integration with multi-location sync is high risk and high effort."
    }
  ]
}
After analyzing, you can pass these requirements directly to quikly_create_proposal.

​
quikly_recommend_rate

Get an AI-powered rate recommendation based on role, seniority, and location. API equivalent: POST /ai/rate-recommendation Parameters:
​
role
string
required
Your role (e.g., “fullstack developer”, “cloud architect”, “data engineer”).
​
seniority
string
required
Seniority level: junior, mid, senior, lead, or principal.
​
location
string
required
Your location (e.g., “Buenos Aires, Argentina”, “Berlin, Germany”, “Austin, TX”).
Example usage:
“What’s the market rate for a senior fullstack developer based in Madrid, Spain?”
Response: The AI returns a recommended hourly rate with market context, including low/median/high ranges for the specified role, seniority, and region.

​
quikly_get_proposal

Retrieve a proposal by its ID. API equivalent: GET /proposals/{id} Parameters:
​
proposal_id
string
required
The UUID of the proposal to retrieve.
Example usage:
“Get the details of proposal 550e8400-e29b-41d4-a716-446655440000”
Response: Full proposal object including name, client, requirements, settings, calculations, status, and timestamps.
Generate a share link for a proposal so the client can view, accept, or reject it. API equivalent: POST /proposals/{id}/share Parameters:
​
proposal_id
string
required
The UUID of the proposal to share.
Example usage:
“Generate a share link for my Acme Corp proposal and send it to john@acme.com”
Response: 
{
  "share_url": "https://app.getquikly.com/p/abc123token",
  "token": "abc123token",
  "expires_at": "2026-04-18T14:30:00Z",
  "is_new": true
}
The share link expires in 15 days. Clients can view the proposal, accept it, reject it, or request revisions — all from that link.

​
Typical workflow

A common pattern when using Quikly MCP tools:
  1. Analyze — use quikly_analyze_brief to turn a raw brief into structured requirements
  2. Price — use quikly_recommend_rate to get a market-calibrated hourly rate
  3. Create — use quikly_create_proposal with the requirements and rate
  4. Review — use quikly_get_proposal to verify the proposal looks correct
  5. Share — use quikly_share_link to send it to the client