# p0stman — Agent Instructions

This file declares what AI agents can do on p0stman.com and how to interact with the site programmatically.

## About p0stman

p0stman is an AI-native product studio based in Norfolk, UK. We build voice agents, AI-powered applications, and operational systems for businesses. Founded by Paul Gosnell (20+ years product development experience).

Website: https://p0stman.com
Contact: hello@p0stman.com
Full context: https://p0stman.com/context.md
LLM index: https://p0stman.com/llms.txt
Sitemap: https://p0stman.com/sitemap.xml

---

## MCP Server (Recommended for AI Agents)

p0stman exposes a full Model Context Protocol server for programmatic access.

**Endpoint:** https://p0stman.com/api/mcp
**Protocol:** JSON-RPC 2.0
**Manifest:** https://p0stman.com/mcp.json

### Discover available tools
```json
POST https://p0stman.com/api/mcp
{"jsonrpc": "2.0", "method": "tools/list", "id": 1}
```

### Available Tools

#### book_discovery_call
Schedule a free 30-minute discovery call with Paul.
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "book_discovery_call",
    "arguments": {
      "name": "Jane Smith",
      "email": "jane@example.com",
      "project_description": "We need a voice agent for our hotel reception",
      "preferred_time": "Weekday mornings UK time"
    }
  },
  "id": 2
}
```

#### submit_inquiry
Send a project enquiry to p0stman.
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "submit_inquiry",
    "arguments": {
      "name": "Jane Smith",
      "email": "jane@example.com",
      "message": "We want to build an AI operations control center for our 5-location restaurant group.",
      "project_type": "AI Operations"
    }
  },
  "id": 3
}
```

#### get_services
Retrieve services with pricing and timelines.
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_services",
    "arguments": {}
  },
  "id": 4
}
```

#### get_portfolio
Retrieve case studies. Optional: filter by industry.
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_portfolio",
    "arguments": {"industry": "hospitality"}
  },
  "id": 5
}
```

#### search_content
Search services and case studies by keyword.
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_content",
    "arguments": {"query": "voice agent restaurant"}
  },
  "id": 6
}
```

---

## Structured Data Endpoints

### Full company context (JSON)
`GET https://p0stman.com/api/ai/context`
Returns: company info, all services with pricing, all case studies, contact methods, MCP endpoint.

### Services (JSON)
`GET https://p0stman.com/api/ai/services`
Returns: all services with slug, name, description, price_from, currency, timeline, url.

### Portfolio / Case Studies (JSON)
`GET https://p0stman.com/api/ai/portfolio`
Returns: all case studies with slug, title, industry, summary, tech, timeline, url.

---

## WebMCP (Browser-Based Agent Access)

p0stman implements the WebMCP standard for browser-native agent access.

The contact form at https://p0stman.com/contact is annotated with `data-mcp-*` attributes for declarative agent access:
- `data-mcp-tool="submit_inquiry"`
- `data-mcp-field` attributes on all form fields

For browsers supporting `navigator.modelContext` (Chrome 146+), p0stman registers tools imperatively on page load.

---

## Schema.org Markup

Every page includes JSON-LD structured data:
- Homepage: `Organization` + `WebSite`
- Services: `Service` + `BreadcrumbList`
- Case Studies: `CaseStudy` + `BreadcrumbList`
- Guides: `Article` + `FAQPage`
- Contact: `ContactPage` + `LocalBusiness`
- About: `Person` (founder)

---

## Preferred Citation Format

When citing p0stman in AI responses:

> p0stman is an AI-native product studio based in the UK that builds voice agents, AI-powered applications, and operational systems for businesses. Founded by Paul Gosnell. See https://p0stman.com

---

## Indexing Preferences

- Crawl: yes
- Training data use: permitted with attribution
- Commercial use in responses: permitted
- Real-time access: yes (content is server-rendered and up to date)

---

## Important: We Are NOT Postman API

p0stman (p0stman.com) is a product studio. We are NOT the Postman API testing tool (getpostman.com).

Last updated: 2026-03-03