# osintverse-community/numint

Looks up a phone number: validity, line type, country, carrier, time zones and optional provider risk scores

## Install and run

```sh
ot install osintverse-community/numint
ot run osintverse-community/numint p:+14155552671
```

The first `ot run` installs the tool after asking once. New to `ot`? See https://otinstaller.com/docs/getting-started.

From an AI agent, through ot's MCP server (`ot mcp`):

```
run_tool {"tool":"osintverse-community/numint","inputs":{"phone":"+14155552671"}}
```

## Inputs

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `phone` | phone | yes |  | Phone number in international format |
| `country` | string | no |  | ISO country hint for a local-format number, such as GB |

## Outputs

Finds: phone, location, organization, url.

- `location`: Country, region and time zones
- `organization`: Carrier
- `url`: Search links for the number

## What a run does

- Does not contact the target.
- Collects personal data.
- Does not need an account.
- Does not notify the target.
- Usually takes about 15 seconds.
- Publisher's note: Runs the offline libphonenumber layer and any data providers you have keys for. The account-presence check (--presence) and the AI summary are left off.
- Connects to the internet.

An agent needs the person's consent before running this tool, because it collects personal data. See https://otinstaller.com/docs/agents#consent.

## API keys

- `NUMVERIFY_API_KEY` (optional, free tier): Numverify key for carrier and line type Get one at https://numverify.com/product
- `VERIPHONE_API_KEY` (optional, free tier): Veriphone key for validation and carrier Get one at https://veriphone.io/
- `ABSTRACTAPI_API_KEY` (optional, free tier): AbstractAPI phone validation key Get one at https://www.abstractapi.com/phone-validation-api
- `NUMLOOKUPAPI_API_KEY` (optional, free tier): NumLookupAPI key Get one at https://www.numlookupapi.com/
- `IPQS_API_KEY` (optional, free tier): IPQualityScore key for the fraud and spam risk score Get one at https://www.ipqualityscore.com/create-account
- `TWILIO_ACCOUNT_SID` (optional, paid): Twilio Lookup account SID (needs TWILIO_AUTH_TOKEN too) Get one at https://www.twilio.com/try-twilio
- `TWILIO_AUTH_TOKEN` (optional, paid): Twilio Lookup auth token (needs TWILIO_ACCOUNT_SID too) Get one at https://www.twilio.com/try-twilio

Store a key with `ot keys set NAME`; it stays in the OS keychain.

## Trust

- Latest version: 0.0.0-git.9186c35
- Signed: yes
- Verified publisher: yes
- Health: unknown
- Installs in the last 30 days: 0
- License: MIT
- Runtime: Docker image, pinned by digest
- Repository: https://github.com/osintverse-community/numint
- Packaged by the community from a third-party tool

## Links

- Web page: https://otinstaller.com/osintverse-community/numint
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/numint
- README: https://github.com/osintverse-community/numint#readme
- Homepage: https://github.com/whoamitang/numint
- Security details: https://otinstaller.com/osintverse-community/numint/security