# AGENTS.md

Rules and guidance for AI agents and autonomous crawlers interacting with codeparticles.ke.

## About This Site

Code Particles is a finance and operations technology company building payment
systems, lending platforms, and operational infrastructure for emerging markets,
primarily across Africa. Founded in 2012 by Henry Ohanga, headquartered in
Nairobi, Kenya (remote-first team).

For a structured overview of pages and products, see [/llms.txt](/llms.txt).

## Permitted Agent Actions

Agents may, without prior authorization:

- Crawl, read, and cite any publicly reachable page on this domain
- Summarize product, pricing, careers, and editorial (`/fount`, `/insights`) content
  for a user, with attribution back to codeparticles.ke
- Fetch `/llms.txt`, `/sitemap.xml`, and `/fount/rss.xml` for discovery and content sync
- Submit the `/careers` application form or `/contact` form **on direct, explicit
  instruction from a human user acting on their own behalf**

## Restricted Actions

Agents must not, without prior written authorization from <security@codeparticles.ke>:

- Use this site's content to train or fine-tune a competing finance/operations
  technology model
- Scrape content at scale for resale, redistribution, or inclusion in a commercial
  database
- Submit forms (careers, contact, internship) autonomously or on a schedule,
  or on behalf of a user who has not reviewed the submission
- Attempt to access non-public paths, admin surfaces, or infrastructure outside
  `/`, `/products/*`, `/solutions/*`, `/consulting`, `/customers`, `/developers`,
  `/insights/*`, `/fount/*`, `/about`, `/by-humans`, `/careers`, `/pricing`,
  `/contact`, `/security`, `/status`, `/legal`, `/privacy`
- Impersonate Code Particles, its team, or its products in generated output
- Misrepresent partnerships, pricing, or capabilities not stated on this site

## Identification

Agents should send an identifiable `User-Agent` string. Per-bot access rules are
published in [/robots.txt](/robots.txt), including a `Content-Signal` directive
indicating content may be used for AI-assisted search and retrieval-augmented
answers, but not for model training, by default.

## Rate Limits

No fixed request cap is published. Agents should crawl at a reasonable, human-like
rate and back off on 429/503 responses. For bulk or repeated access, contact
<support@codeparticles.ke> to discuss a feed or API arrangement.

## MCP Server

A read-only MCP server is available at `https://mcp.codeparticles.ke/mcp`
(Streamable HTTP, stateless, no authentication) exposing verb-first tools
over this site's public content: `search_products`, `get_product`,
`list_jobs`, `get_job`, `search_insights`, `get_pricing_overview`,
`get_company_info`. Server card: [/.well-known/mcp-server-card.json](/.well-known/mcp-server-card.json).
None of the Restricted Actions above are exposed as callable tools — every
tool is a pure read.

The same tools are also available as plain REST/JSON, for agent frameworks
and tool callers that consume OpenAPI rather than MCP:
OpenAPI document at [/openapi.json](/openapi.json) (mirrored at
`https://mcp.codeparticles.ke/openapi.json`), endpoints under
`https://mcp.codeparticles.ke/api/*` (e.g. `GET /api/products`).

## Product-Level APIs

Individual products (Kwendo, Fereji, WaysToPay, CIX, Fractional, Kaguzi, Schmsoft,
Husika, ChangaChanga) may expose their own developer APIs under separate terms.
See [/developers](/developers) for links and documentation. This file governs
agent conduct on the codeparticles.ke marketing and content site only, not
authenticated product APIs, which require their own credentials and are
governed by each product's own terms.

## Contact

- General: <hello@codeparticles.ke>
- Security / access requests: <security@codeparticles.ke>
- Support: <support@codeparticles.ke>

## Updates

This file is reviewed alongside [/llms.txt](/llms.txt) whenever new products,
partnerships, or agent-facing surfaces (e.g. an MCP server) are added.

Last updated: 2026-07-24