# Stranded Gas Pro - Full Platform Documentation for AI

> Capitalize on Energy Assets - Site, Deploy, Operate

## Overview

Stranded Gas Pro is the platform for distributed energy businesses. We help companies find energy opportunities, deploy projects, and operate at scale.

This document provides detailed information for AI assistants integrating with our platform.

## Platform Capabilities

### SITE - Find Opportunities
- Stranded Gas Finder: Search for available gas sources by location
- Equipment Marketplace: Browse generators, services, infrastructure
- Site Listings: Operators list available gas for power generation
- Gas Quality Calculator: Analyze gas composition and suitability
- Genset Derate Calculator: Model generator performance

### DEPLOY - Execute Projects
- Financial Modeling: NPV, IRR, sensitivity analysis for energy projects
- Project Management: Kanban boards with tasks, subtasks, assignments
- Vendor Coordination: Connect with equipment and service providers
- Compute Economics: Specialized modeling for Bitcoin mining projects

### OPERATE - Run Your Business
- Energy CRM: Companies, contacts, opportunities with energy-specific workflows
- Site Management: Track physical locations with notes and links
- Data Rooms: Secure document sharing with access control
- E-Signature: Digital signature workflows for contracts
- Gas Nominations: Production agreements, calendar, billing
- Team Management: Role-based access control

---

## MCP Server Integration

Endpoint: `https://api.strandedgas.pro/api/mcp/`
Protocol: JSON-RPC 2.0
Authentication: Bearer token with API key (prefix: sgp_)

### Request Format
```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tool_name",
    "arguments": { ... }
  }
}
```

### Available Methods
- `initialize` - Server handshake
- `tools/list` - Get available tools and schemas
- `tools/call` - Execute a tool

---

## MCP Tool Reference (57 Tools)

### User Context Tools (3)

#### get_platform_info
Get platform terminology, concepts, and abbreviations.
- No parameters required

#### get_my_companies
List companies the authenticated user has access to.
- No parameters required

#### get_my_profile
Get the current user's profile information.
- No parameters required

---

### Task Management Tools (12)

#### task_get_filter_options
Get filter options for task searches: team members, projects, labels, priorities.
- `owner_company_id` (required): Company ID

#### task_list_projects
List task projects (kanban boards) for a company.
- `owner_company_id` (required): Company ID
- `search` (optional): Search query

#### task_get_project
Get a task project with its columns and tasks.
- `project_id` (required): Project ID

#### task_create_project
Create a new task project (kanban board).
- `owner_company_id` (required): Company ID
- `name` (required): Project name

#### task_archive_project
Archive a task project.
- `project_id` (required): Project ID

#### task_list_tasks
List tasks with optional filters.
- `owner_company_id` (required): Company ID
- `project_id` (optional): Filter by project
- `assignee_id` (optional): Filter by assignee
- `priority` (optional): Filter by priority
- `search` (optional): Search query

#### task_get_task
Get detailed task information including subtasks.
- `task_id` (required): Task ID

#### task_create
Create a new task.
- `owner_company_id` (required): Company ID
- `title` (required): Task title
- `project_id` (optional): Project to add task to
- `column_id` (optional): Column within project
- `assignee_id` (optional): User to assign
- `priority` (optional): URGENT, IMPORTANT, NORMAL, LOW
- `due_date` (optional): Due date (YYYY-MM-DD)
- `description` (optional): Task description

#### task_update
Update an existing task.
- `task_id` (required): Task ID
- `title` (optional): New title
- `description` (optional): New description
- `priority` (optional): New priority
- `due_date` (optional): New due date
- `assignee_id` (optional): New assignee
- `column_id` (optional): Move to column

#### task_complete
Mark a task as complete.
- `task_id` (required): Task ID

#### task_add_subtask
Add a subtask to a task.
- `task_id` (required): Parent task ID
- `title` (required): Subtask title

#### task_add_comment
Add a comment to a task.
- `task_id` (required): Task ID
- `content` (required): Comment text

---

### Site Management Tools (9)

#### site_list
List physical sites for a company.
- `owner_company_id` (required): Company ID
- `search` (optional): Search query
- `include_archived` (optional): Include archived sites

#### site_get
Get detailed site information.
- `site_id` (required): Site ID

#### site_create
Create a new site.
- `owner_company_id` (required): Company ID
- `name` (required): Site name
- `description` (optional): Site description
- `address` (optional): Physical address
- `latitude` (optional): GPS latitude
- `longitude` (optional): GPS longitude

#### site_update
Update a site.
- `site_id` (required): Site ID
- `name` (optional): New name
- `description` (optional): New description
- `address` (optional): New address
- `latitude` (optional): New latitude
- `longitude` (optional): New longitude

#### site_archive
Archive a site.
- `site_id` (required): Site ID

#### site_add_note
Add a note to a site.
- `site_id` (required): Site ID
- `content` (required): Note content

#### site_list_notes
List notes for a site.
- `site_id` (required): Site ID

#### site_add_link
Link two sites together.
- `site_id` (required): Source site ID
- `linked_site_id` (required): Target site ID

#### site_remove_link
Remove a link between sites.
- `site_id` (required): Source site ID
- `linked_site_id` (required): Target site ID

---

### Data Room & Document Tools (12)

#### upload_file
Upload a small file as base64 (not recommended for large files).
- `owner_company_id` (required): Company ID
- `filename` (required): File name
- `content_base64` (required): Base64 encoded content
- `content_type` (optional): MIME type

#### upload_start
Start a presigned S3 upload session (recommended for large files).
- `owner_company_id` (required): Company ID
- `filename` (required): File name
- `content_type` (required): MIME type
- `size` (required): File size in bytes

#### upload_complete
Complete a multipart upload.
- `upload_id` (required): Upload session ID
- `parts` (required): Array of {part_number, etag}

#### data_room_create
Create a new data room.
- `owner_company_id` (required): Company ID
- `name` (required): Data room name

#### data_room_list
List data rooms for a company.
- `owner_company_id` (required): Company ID

#### data_room_get_tree
Get the folder/document tree structure of a data room.
- `data_room_id` (required): Data room ID

#### data_room_get_download_url
Get a presigned download URL for a document.
- `document_id` (required): Document ID

#### data_room_add_file
Add an uploaded file to a data room.
- `data_room_id` (required): Data room ID
- `upload_id` (required): Upload ID from upload_file or upload_complete
- `folder_id` (optional): Target folder ID

#### data_room_create_folder
Create a folder in a data room.
- `data_room_id` (required): Data room ID
- `name` (required): Folder name
- `parent_folder_id` (optional): Parent folder ID

#### data_room_rename_document
Rename a document.
- `document_id` (required): Document ID
- `name` (required): New name

#### data_room_rename_folder
Rename a folder.
- `folder_id` (required): Folder ID
- `name` (required): New name

#### data_room_delete_document
Delete a document.
- `document_id` (required): Document ID

#### data_room_delete_folder
Delete a folder (must be empty).
- `folder_id` (required): Folder ID

#### data_room_move_folder
Move a folder to a new parent.
- `folder_id` (required): Folder ID
- `parent_folder_id` (optional): New parent folder ID (null for root)

---

### CRM Tools (20)

#### crm_get_filter_options
Get CRM filter options: team members, statuses, types, deal types.
- `owner_company_id` (required): Company ID

#### crm_company_list
List CRM companies (leads/prospects).
- `owner_company_id` (required): Company ID
- `search` (optional): Search query
- `client_status` (optional): Filter by status
- `assigned_to_id` (optional): Filter by assignee

#### crm_company_get
Get detailed CRM company information.
- `crm_company_id` (required): CRM Company ID

#### crm_company_create
Create a new CRM company.
- `owner_company_id` (required): Company ID
- `name` (required): Company name
- `client_status` (optional): Status
- `assigned_to_id` (optional): Assignee user ID
- `website` (optional): Website URL
- `notes` (optional): Notes

#### crm_company_update
Update a CRM company.
- `crm_company_id` (required): CRM Company ID
- `name` (optional): New name
- `client_status` (optional): New status
- `assigned_to_id` (optional): New assignee
- `website` (optional): New website
- `notes` (optional): New notes

#### crm_company_delete
Delete a CRM company.
- `crm_company_id` (required): CRM Company ID

#### crm_company_add_note
Add a note to a CRM company.
- `crm_company_id` (required): CRM Company ID
- `content` (required): Note content

#### crm_contact_list
List contacts.
- `owner_company_id` (required): Company ID
- `crm_company_id` (optional): Filter by CRM company
- `search` (optional): Search query

#### crm_contact_get
Get detailed contact information.
- `contact_id` (required): Contact ID

#### crm_contact_create
Create a new contact.
- `owner_company_id` (required): Company ID
- `first_name` (required): First name
- `last_name` (required): Last name
- `crm_company_id` (optional): Associated CRM company
- `email` (optional): Email address
- `phone` (optional): Phone number
- `title` (optional): Job title

#### crm_contact_update
Update a contact.
- `contact_id` (required): Contact ID
- `first_name` (optional): New first name
- `last_name` (optional): New last name
- `email` (optional): New email
- `phone` (optional): New phone
- `title` (optional): New title

#### crm_contact_delete
Delete a contact.
- `contact_id` (required): Contact ID

#### crm_contact_add_note
Add a note to a contact.
- `contact_id` (required): Contact ID
- `content` (required): Note content

#### crm_opportunity_list
List opportunities.
- `owner_company_id` (required): Company ID
- `crm_company_id` (optional): Filter by CRM company
- `opportunity_type` (optional): Filter by type
- `assigned_to_id` (optional): Filter by assignee
- `search` (optional): Search query

#### crm_opportunity_get
Get detailed opportunity information.
- `opportunity_id` (required): Opportunity ID

#### crm_opportunity_create
Create a new opportunity.
- `owner_company_id` (required): Company ID
- `name` (required): Opportunity name
- `crm_company_id` (optional): Associated CRM company
- `opportunity_type` (optional): Type
- `deal_type_id` (optional): Deal type ID
- `assigned_to_id` (optional): Assignee
- `value` (optional): Deal value
- `probability` (optional): Win probability (0-100)
- `expected_close_date` (optional): Expected close date

#### crm_opportunity_update
Update an opportunity.
- `opportunity_id` (required): Opportunity ID
- `name` (optional): New name
- `opportunity_type` (optional): New type
- `deal_type_id` (optional): New deal type
- `assigned_to_id` (optional): New assignee
- `value` (optional): New value
- `probability` (optional): New probability
- `expected_close_date` (optional): New expected close date

#### crm_opportunity_delete
Delete an opportunity.
- `opportunity_id` (required): Opportunity ID

#### crm_opportunity_add_note
Add a note to an opportunity.
- `opportunity_id` (required): Opportunity ID
- `content` (required): Note content

---

## Platform Terminology

- **SGP**: Stranded Gas Pro
- **Site**: Physical location (well pad, facility, data center, etc.)
- **Site Listing**: Marketplace listing for gas availability (different from Site)
- **Offering**: Supplier product/service listing in the marketplace
- **Data Room**: Secure document storage with folder organization and access control
- **Task Project**: Kanban board for task management
- **CRM Company**: Lead/prospect record in the CRM (not a platform Company)
- **Company**: Platform organization that users belong to
- **Owner Company**: The company that owns/controls a resource

---

## User Types

- **Buyers**: Find gas sources and equipment, express interest
- **Operators/Sellers**: List stranded gas sites for power generation
- **Suppliers**: List equipment and services, manage storefronts
- **Companies**: Full platform access including CRM, projects, sites, back office tools

---

## REST API

Full REST API available at: https://api.strandedgas.pro
Authentication: JWT tokens (via /api/auth/login/) or API keys (Bearer token)

---

## Contact

Website: https://strandedgas.pro
Contact Form: https://strandedgas.pro/contact