Main Page: Difference between revisions

From Public AI Wiki
Browse history interactively
← Older edit
VisualWikitext
No edit summary
No edit summary
 
(6 intermediate revisions by the same user not shown)
Line 15: Line 15:
* '''Crisis Support''': Get current hotline numbers and resources for mental health emergencies
* '''Crisis Support''': Get current hotline numbers and resources for mental health emergencies
* '''Transit Information''': Real-time public transportation schedules and routes
* '''Transit Information''': Real-time public transportation schedules and routes
* '''Events & Activities''': Discover upcoming community events and festivals
* '''Location Services''': Search for places and get geographic information
* '''Location Services''': Search for places and get geographic information
* '''And more...''': Any information that benefits from being current, localized, and structured
* '''And more...''': Any information that benefits from being current, localized, and structured
== Understanding Public AI Tools ==
Public AI has two types of tools, each serving different purposes:
{| class="wikitable" style="width: 100%;"
! style="width: 50%;" | Wiki Tools
! style="width: 50%;" | MCP Tools
|-
| '''Data lives in this wiki'''<br/>The MCP server reads and serves wiki content to AI assistants
| '''Code lives in GitHub repository'''<br/>Python functions that integrate with external APIs
|-
| '''Examples:'''
* [[Tool:SuicideHotline]] - Crisis hotlines with custom SuicideHotlineResource template
* [[Tool:UpcomingEvents]] - Events with custom UpcomingEventsResource template
| '''Examples:'''
* Swiss Transit - Calls transport.opendata.ch API
* Singapore Carparks - Queries data.gov.sg API
|-
| '''Who can contribute:''' Anyone (no coding required)
| '''Who can contribute:''' Developers (Python required)
|-
| '''Best for:'''
* Location-specific resources
* Information that changes over time
* Data that needs community verification
* Custom data structures per tool
| '''Best for:'''
* Real-time API integrations
* Complex data processing
* External service connections
|}


== Browse All Tools ==
== Browse All Tools ==
Line 22: Line 55:
{{#cargo_query:
{{#cargo_query:
tables=Tools
tables=Tools
|fields=_pageName=Tool,description,tool_type
|fields=_pageName=Tool,description,community,has_resources
|order by=tool_type,_pageName
|order by=_pageName
|format=table
|format=table
|headers show
|headers show
}}
}}


== Recent Resources ==
== How to Contribute ==
 
Choose your contribution pathway based on what you want to do:
 
=== 1️⃣ Add Data to an Existing Tool ===
 
'''Add or update localized data for an existing tool'''
 
'''Difficulty:''' Easy (no coding required)
 
'''Perfect for:'''
* Adding suicide hotline numbers for your country
* Contributing upcoming events in your region
* Adding local crisis resources
* Verifying and updating existing information
 
'''Quick start:'''
# Browse the tools above and find one with <code>has_resources=true</code>
# Check the tool's page for its custom resource template (e.g., [[Template:SuicideHotlineResource]], [[Template:UpcomingEventsResource]])
# Create or edit a page: <code>Resource:ToolName/YourLocation</code>
# Use the tool's specific resource template with the appropriate fields
# Fill in your local data and save!


{{#cargo_query:
'''💡 Tip:''' Look at existing resources for that tool to see what fields are available and how to format your data.
tables=ToolResources
 
|fields=_pageName=Resource,country,tool
----
|order by=last_verified DESC
 
|limit=10
=== 2️⃣ Create a New Wiki Tool ===
|format=table
 
|headers show
'''Design a new tool with a custom data structure'''
}}
 
'''Difficulty:''' Medium
 
'''When to use this:'''
* You have location-specific data that communities can maintain
* The information doesn't require API calls
* You need a specific data structure for your use case
 
'''Quick start:'''
# Create <code>Template:YourToolNameResource</code> - define your data fields (see [[Template:SuicideHotlineResource]] or [[Template:UpcomingBTOResource]] as examples)
# Create <code>Tool:YourToolName</code> - use the {{tl|Tool}} template with <code>has_resources=true</code>
# Create <code>Resource:YourToolName/Location</code> - add your first resource using your template
# Go to [[Special:CargoTables]], find your table, and click "Recreate data"
 
'''💡 Important:''' ALL resource templates must include these baseline fields: <code>tool</code>, <code>country</code>, <code>region</code>, <code>last_verified</code>. Your table name must be <code>YourToolNameResources</code> for the MCP server to work.
 
----


== How to Contribute ==
=== 3️⃣ Add a New MCP Tool ===


=== Adding a New Tool ===
'''Implement a Python tool that integrates with external APIs'''


# Create a page with the prefix '''Tool:''' (e.g., [[Tool:YourToolName]])
'''Difficulty:''' Advanced (requires Python/coding)
# Use the [[Template:Tool]] template
# Fill in the required parameters:
#* '''name''': Display name of the tool
#* '''description''': Brief description (one sentence)
#* '''tool_type''': Category (Crisis Support, Transit, Mapping, General)
#* '''has_resources''': Set to "true" if this tool has locale-specific resources
#* '''overview''': Detailed explanation of what the tool does
#* '''usage''': Instructions on how to use the tool


'''Example:'''
'''When to use this:'''
<pre>
* You need to call external APIs (weather, transit, etc.)
{{Tool
* The tool requires real-time data
|name=Weather Alerts
* Complex logic or data transformation is needed
|description=Real-time weather alerts and warnings by region
|tool_type=General
|has_resources=true
|overview=Provides severe weather alerts...
|usage=Query by country or region...
}}
</pre>


=== Adding a Resource to an Existing Tool ===
'''Quick start:'''
# Fork the [https://github.com/forpublicai/pai-mcp-server repository]
# Add your <code>@mcp.tool()</code> function to <code>main.py</code>
# Test locally with <code>python main.py</code>
# Submit a Pull Request


# Create a page with format '''Resource:ToolName/Location''' (e.g., [[Resource:SuicideHotline/Singapore]])
'''Example tools to create:'''
# Use the [[Template:ToolResource]] template
* Weather API integrations
# Fill in the parameters:
* Stock market data
#* '''tool''': Link to parent tool (e.g., "Tool:SuicideHotline")
* Real-time transit for other countries
#* '''country''': Country name
* News aggregators
#* '''region''': (Optional) State/province/region
#* '''data_field1_name''' through '''data_field5_name''': Custom field names
#* '''data_field1_value''' through '''data_field5_value''': Values for those fields
#* '''additional_info''': Any extra information
#* '''details''': Long-form content
#* '''last_verified''': Date you verified this information (YYYY-MM-DD format)


'''Example:'''
----
<pre>
{{ToolResource
|tool=Tool:SuicideHotline
|country=United States
|region=National
|data_field1_name=Phone
|data_field1_value=988 (Suicide & Crisis Lifeline, 24/7)
|data_field2_name=Text Service
|data_field2_value=Text "HELLO" to 741741 (Crisis Text Line)
|additional_info=Free and confidential support
|last_verified=2024-01-15
}}
</pre>


=== Updating Existing Information ===
=== Quick Decision Guide ===


# Find the resource page you want to update
{| class="wikitable"
# Click "Edit" at the top of the page
! I want to...
# Update the relevant fields
! Use this pathway
# '''Important''': Update the '''last_verified''' date to today's date
|-
# Save the page
| Add data to an existing tool
# Navigate to [[Special:CargoTables]] and click "Recreate" for the ToolResources table
| <span style="font-size: 1.2em;">1️⃣</span> Add Data to an Existing Tool
|-
| Create a tool with custom data fields
| <span style="font-size: 1.2em;">2️⃣</span> Create a New Wiki Tool
|-
| Build an API integration or complex tool
| <span style="font-size: 1.2em;">3️⃣</span> Add a New MCP Tool
|}


== Technical Documentation ==
----


=== For Developers ===
== Examples to Learn From ==


This wiki uses:
'''Well-designed Tools:'''
* '''MediaWiki''': The underlying wiki platform
* [[Tool:SuicideHotline]] + [[Template:SuicideHotlineResource]] - Crisis resources with multiple contact methods
* '''Cargo Extension''': Structured data storage and querying
* [[Tool:UpcomingEvents]] + [[Template:UpcomingEventsResource]] - Events with dates and venue information
* '''FastMCP Server''': Exposes wiki data as MCP tools for AI assistants
* [[Tool:UpcomingBTO]] + [[Template:UpcomingBTOResource]] - Single-country tool (region field left empty)


=== API Access ===
== How Resource Templates Work ==


Data can be queried via:
Each tool defines its own resource template with exactly the fields it needs:
* '''MediaWiki API''': Standard MediaWiki API endpoints
* '''Cargo API''': Special:CargoQuery for structured queries
* '''MCP Server''': FastMCP server provides simplified access for AI assistants


=== Cargo Tables ===
{| class="wikitable"
! Tool
! Template
! Custom Fields
! Notes
|-
| [[Tool:SuicideHotline]]
| [[Template:SuicideHotlineResource]]
| primary_phone, secondary_phone, text_service, online_chat_url, youth_hotline, emergency_services, languages, availability
| Multi-country, uses region for states/provinces
|-
| [[Tool:UpcomingEvents]]
| [[Template:UpcomingEventsResource]]
| event_name, event_type, start_date, end_date, venue, address, admission, description, registration_url
| Multi-country, region optional
|-
| [[Tool:UpcomingBTO]]
| [[Template:UpcomingBTOResource]]
| launch_month, location, unit_count, flat_types, classification
| Single-country (Singapore only), region left empty
|-
| Your tool!
| [[Template:YourToolResource]]
| Whatever fields you need!
| Remember: tool, country, region, last_verified are always required
|}


View and manage the structured data:
This gives tool creators complete flexibility to structure their data appropriately.
* [[Special:CargoTables|View all Cargo tables]]
* '''Tools''' table: Stores all tool definitions
* '''ToolResources''' table: Stores locale-specific resource data


== Guidelines ==
== Guidelines ==
Line 131: Line 197:


* '''Accuracy''': All information must be current and verified
* '''Accuracy''': All information must be current and verified
* '''Verification''': Always include a '''last_verified''' date
* '''Verification''': Always include a <code>last_verified</code> date
* '''Completeness''': Provide all relevant contact methods (phone, text, online)
* '''Completeness''': Fill in all relevant fields for your resource
* '''Localization''': Information should be specific to the country/region
* '''Localization''': Information should be specific to the country/region
* '''Neutrality''': Present information objectively without bias
* '''Neutrality''': Present information objectively without bias
Line 138: Line 204:
=== What Belongs Here ===
=== What Belongs Here ===


✅ '''Good candidates for Public AI:'''
✅ '''Good candidates for Wiki Tools:'''
* Information that changes over time (phone numbers, schedules)
* Information that changes over time (phone numbers, schedules, events)
* Localized data (country/region-specific resources)
* Localized data (country/region-specific resources)
* Public services (hotlines, transit, emergency services)
* Public services (hotlines, transit, emergency services, events)
* Data that AI assistants frequently need but may not have current info on
* Data that AI assistants frequently need but may not have current info on
* Information that benefits from community verification


❌ '''Not appropriate:'''
❌ '''Not appropriate:'''
Line 149: Line 216:
* Information that rarely changes and is well-known (e.g., historical facts)
* Information that rarely changes and is well-known (e.g., historical facts)
* Opinion pieces or subjective content
* Opinion pieces or subjective content
 
* Time-sensitive data that changes by the minute (use MCP tools with APIs instead)
== Need Help? ==
 
* [[Template:Tool|View Tool Template Documentation]]
* [[Template:ToolResource|View Resource Template Documentation]]
* [[Special:CargoTables|Manage Cargo Tables]]




[[Category:Public AI]]
[[Category:Public AI]]

Latest revision as of 08:33, 26 December 2025

Public AI is a structured knowledge base of tools and resources that AI assistants can access programmatically to help users with real-world tasks.

What is Public AI?[edit | edit source]

Public AI serves as a bridge between AI assistants (like Claude, ChatGPT, etc.) and real-world information that users need. Instead of AI assistants having outdated or incomplete information, they can query this wiki to get current, accurate, and localized data.

How It Works[edit | edit source]

  1. Structured Data: Information is stored using MediaWiki's Cargo extension, making it queryable like a database
  2. MCP Server: A FastMCP server reads from this wiki and exposes the data as tools that AI assistants can use
  3. AI Integration: When you ask an AI assistant a question (e.g., "What's the suicide hotline in Singapore?"), it queries this wiki and gives you current information

Use Cases[edit | edit source]

  • Crisis Support: Get current hotline numbers and resources for mental health emergencies
  • Transit Information: Real-time public transportation schedules and routes
  • Events & Activities: Discover upcoming community events and festivals
  • Location Services: Search for places and get geographic information
  • And more...: Any information that benefits from being current, localized, and structured

Understanding Public AI Tools[edit | edit source]

Public AI has two types of tools, each serving different purposes:

Wiki Tools MCP Tools
Data lives in this wiki
The MCP server reads and serves wiki content to AI assistants 		Code lives in GitHub repository
Python functions that integrate with external APIs
Examples: Examples:
  • Swiss Transit - Calls transport.opendata.ch API
  • Singapore Carparks - Queries data.gov.sg API
Who can contribute: Anyone (no coding required) Who can contribute: Developers (Python required)
Best for:
  • Location-specific resources
  • Information that changes over time
  • Data that needs community verification
  • Custom data structures per tool
 Best for:
  • Real-time API integrations
  • Complex data processing
  • External service connections

Browse All Tools[edit | edit source]

Tool description community has resources
Main Page No
Tool:SuicideHotline International suicide prevention hotlines and crisis support resources Singapore • Switzerland Yes
Tool:UpcomingBTO Upcoming Build-To-Order (BTO) public housing launches in Singapore Singapore Yes
Tool:UpcomingEvents Community and public events happening in various locations Singapore Yes

How to Contribute[edit | edit source]

Choose your contribution pathway based on what you want to do:

1️⃣ Add Data to an Existing Tool[edit | edit source]

Add or update localized data for an existing tool

Difficulty: Easy (no coding required)

Perfect for:

  • Adding suicide hotline numbers for your country
  • Contributing upcoming events in your region
  • Adding local crisis resources
  • Verifying and updating existing information

Quick start:

  1. Browse the tools above and find one with has_resources=true
  2. Check the tool's page for its custom resource template (e.g., Template:SuicideHotlineResource, Template:UpcomingEventsResource)
  3. Create or edit a page: Resource:ToolName/YourLocation
  4. Use the tool's specific resource template with the appropriate fields
  5. Fill in your local data and save!

💡 Tip: Look at existing resources for that tool to see what fields are available and how to format your data.

2️⃣ Create a New Wiki Tool[edit | edit source]

Design a new tool with a custom data structure

Difficulty: Medium

When to use this:

  • You have location-specific data that communities can maintain
  • The information doesn't require API calls
  • You need a specific data structure for your use case

Quick start:

  1. Create Template:YourToolNameResource - define your data fields (see Template:SuicideHotlineResource or Template:UpcomingBTOResource as examples)
  2. Create Tool:YourToolName - use the Template:Tl template with has_resources=true
  3. Create Resource:YourToolName/Location - add your first resource using your template
  4. Go to Special:CargoTables, find your table, and click "Recreate data"

💡 Important: ALL resource templates must include these baseline fields: tool, country, region, last_verified. Your table name must be YourToolNameResources for the MCP server to work.

3️⃣ Add a New MCP Tool[edit | edit source]

Implement a Python tool that integrates with external APIs

Difficulty: Advanced (requires Python/coding)

When to use this:

  • You need to call external APIs (weather, transit, etc.)
  • The tool requires real-time data
  • Complex logic or data transformation is needed

Quick start:

  1. Fork the repository
  2. Add your @mcp.tool() function to main.py
  3. Test locally with python main.py
  4. Submit a Pull Request

Example tools to create:

  • Weather API integrations
  • Stock market data
  • Real-time transit for other countries
  • News aggregators

Quick Decision Guide[edit | edit source]

I want to... Use this pathway
Add data to an existing tool 1️⃣ Add Data to an Existing Tool
Create a tool with custom data fields 2️⃣ Create a New Wiki Tool
Build an API integration or complex tool 3️⃣ Add a New MCP Tool

Examples to Learn From[edit | edit source]

Well-designed Tools:

How Resource Templates Work[edit | edit source]

Each tool defines its own resource template with exactly the fields it needs:

Tool Template Custom Fields Notes
Tool:SuicideHotline Template:SuicideHotlineResource primary_phone, secondary_phone, text_service, online_chat_url, youth_hotline, emergency_services, languages, availability Multi-country, uses region for states/provinces
Tool:UpcomingEvents Template:UpcomingEventsResource event_name, event_type, start_date, end_date, venue, address, admission, description, registration_url Multi-country, region optional
Tool:UpcomingBTO Template:UpcomingBTOResource launch_month, location, unit_count, flat_types, classification Single-country (Singapore only), region left empty
Your tool! Template:YourToolResource Whatever fields you need! Remember: tool, country, region, last_verified are always required

This gives tool creators complete flexibility to structure their data appropriately.

Guidelines[edit | edit source]

Quality Standards[edit | edit source]

  • Accuracy: All information must be current and verified
  • Verification: Always include a last_verified date
  • Completeness: Fill in all relevant fields for your resource
  • Localization: Information should be specific to the country/region
  • Neutrality: Present information objectively without bias

What Belongs Here[edit | edit source]

✅ Good candidates for Wiki Tools:

  • Information that changes over time (phone numbers, schedules, events)
  • Localized data (country/region-specific resources)
  • Public services (hotlines, transit, emergency services, events)
  • Data that AI assistants frequently need but may not have current info on
  • Information that benefits from community verification

❌ Not appropriate:

  • Personal or private information
  • Copyrighted content without permission
  • Information that rarely changes and is well-known (e.g., historical facts)
  • Opinion pieces or subjective content
  • Time-sensitive data that changes by the minute (use MCP tools with APIs instead)
Retrieved from "https://wiki.publicai.co/w/index.php?title=Main_Page&oldid=104"